Skip to content

docs(cache): Clarify custom cache key behavior with single-file purge#32107

Open
mbullock1986 wants to merge 1 commit into
cloudflare:productionfrom
mbullock1986:cache-rules-custom-key-purge-docs
Open

docs(cache): Clarify custom cache key behavior with single-file purge#32107
mbullock1986 wants to merge 1 commit into
cloudflare:productionfrom
mbullock1986:cache-rules-custom-key-purge-docs

Conversation

@mbullock1986

Copy link
Copy Markdown
Collaborator

Cache Rules that set custom cache keys require API purge with headers/cookies rather than dashboard single-file purge. This clarification reduces customer escalations about why single-file purge does not invalidate cached resources.

Summary

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@mbullock1986
mbullock1986 requested review from a team, ack-cf and zaidoon1 as code owners July 16, 2026 14:34
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No issues found in commit b4f73b5.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

@github-actions github-actions Bot added product:cache Issues or PRs related to Cache size/s labels Jul 16, 2026
Cache Rules that set custom cache keys require API purge with headers/cookies
rather than dashboard single-file purge. This clarification reduces customer
escalations about why single-file purge does not invalidate cached resources.
@mbullock1986
mbullock1986 force-pushed the cache-rules-custom-key-purge-docs branch from 599793d to b4f73b5 Compare July 17, 2026 08:31
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.

3 participants