# Next.js revalidateTag profile max stale while revalidate

Status: search-observed
Product: Next.js
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/next-js-revalidatetag-profile-max-stale-while-revalidate
Machine JSON: https://gitdocs.org/api/fixes/next-js-revalidatetag-profile-max-stale-while-revalidate.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

Local code often type-checks under both old and new framework semantics; the failure depends on the installed framework version and current runtime defaults.

## Fix

```
Verifier checks behavior across multiple requests/build modes, not merely compilation. Check request count, response freshness, and render behavior over multiple calls.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- site:nextjs.org/docs revalidateTag Next.js 16 stale-while-revalidate profile="max"
- Next.js revalidateTag profile max stale while revalidate
- https://nextjs.org/docs/app/api-reference/functions/revalidateTag
- https://nextjs.org/docs/app/api-reference/functions/updateTag

## Sources

- Next.js 16: https://nextjs.org/blog/next-16
- Official reference opened by Codex: https://nextjs.org/docs/app/api-reference/functions/revalidateTag
- Official reference opened by Codex: https://nextjs.org/docs/app/api-reference/functions/updateTag