Skip to content

[Cache] Document s-maxage interaction with stale-while-revalidate#30790

Open
ngayerie wants to merge 1 commit into
cloudflare:productionfrom
ngayerie:ngayerie/CACHE-13507
Open

[Cache] Document s-maxage interaction with stale-while-revalidate#30790
ngayerie wants to merge 1 commit into
cloudflare:productionfrom
ngayerie:ngayerie/CACHE-13507

Conversation

@ngayerie
Copy link
Copy Markdown
Contributor

Adds documentation explaining that s-maxage disables stale-while-revalidate per RFC 9111 (s-maxage implies proxy-revalidate semantics).

Updates:

  • cache-control.mdx: Added caution note under s-maxage definition and in SWR example
  • revalidation.mdx: Added caution note in Controlling stale behavior section

Workaround documented: Use max-age + stale-while-revalidate at origin, then set Edge Cache TTL via Cache Rules for different edge/browser TTLs.

Addresses CACHE-13507 and prevents escalations like ESCALATION-1255

Adds documentation explaining that s-maxage disables stale-while-revalidate
per RFC 9111 (s-maxage implies proxy-revalidate semantics).

Updates:
- cache-control.mdx: Added caution note under s-maxage definition and in SWR example
- revalidation.mdx: Added caution note in Controlling stale behavior section

Workaround documented: Use max-age + stale-while-revalidate at origin,
then set Edge Cache TTL via Cache Rules for different edge/browser TTLs.

Addresses CACHE-13507 and prevents escalations like ESCALATION-1255
@github-actions github-actions Bot added product:cache Issues or PRs related to Cache size/s labels May 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:cache Issues or PRs related to Cache size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant