Skip to content

[Cache Rules] Document "is in list" and "is not in list" operators in hostname match expressions#30902

Open
jayeve wants to merge 1 commit into
cloudflare:productionfrom
jayeve:jayeve/cache-rules-hostname-custom-lists
Open

[Cache Rules] Document "is in list" and "is not in list" operators in hostname match expressions#30902
jayeve wants to merge 1 commit into
cloudflare:productionfrom
jayeve:jayeve/cache-rules-hostname-custom-lists

Conversation

@jayeve
Copy link
Copy Markdown
Collaborator

@jayeve jayeve commented May 18, 2026

Document the "is in list" and "is not in list" operators for Cache Rules. These operators allow Enterprise customers to match requests against custom hostname lists in cache rule expressions — for example, applying a caching configuration to all hostnames in a managed list rather than enumerating them individually.

Changes:

  • settings.mdx: Add "is in list" / "is not in list" to the available operators list, with a note explaining they are available for the Hostname field on Enterprise plans and linking to the custom lists documentation.
  • New example (cache-by-hostname-list.mdx): Add an example showing how to create a cache rule that caches everything for hostnames matching a custom hostname list, with both Expression Builder and Expression Editor syntax.

Context:

  • The corresponding dashboard change exposes the "is in list" operator in the cache rules expression builder for Enterprise zones.
  • Note: The custom lists documentation currently lives under /waf/tools/lists/ despite being an account-level, product-agnostic feature used by 11+ products (WAF, DDoS, Network Firewall, Cloudflare One, etc.). A future effort could relocate it to a more neutral home like /rules/ or /ruleset-engine/.
  • 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.

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.

… rule expressions

Document the "is in list" and "is not in list" operators for Cache Rules. These operators allow Enterprise customers to match requests against custom hostname lists in cache rule expressions — for example, applying a caching configuration to all hostnames in a managed list rather than enumerating them individually.

Changes:
- **`settings.mdx`**: Add "is in list" / "is not in list" to the available operators list, with a note explaining they are available for the Hostname field on Enterprise plans and linking to the custom lists documentation.
- **New example (`cache-by-hostname-list.mdx`)**: Add an example showing how to create a cache rule that caches everything for hostnames matching a custom hostname list, with both Expression Builder and Expression Editor syntax.

Context:
- **Jira**: [CACHE-11044](https://jira.cfdata.org/browse/CACHE-11044)
- The corresponding dashboard change exposes the "is in list" operator in the cache rules expression builder for Enterprise zones.
- Note: The custom lists documentation currently lives under `/waf/tools/lists/` despite being an account-level, product-agnostic feature used by 11+ products (WAF, DDoS, Network Firewall, Cloudflare One, etc.). A future effort could relocate it to a more neutral home like `/rules/` or `/ruleset-engine/`.

<!-- Before: Cache rules Hostname operator dropdown missing "is in list" -->
<!-- After: Cache rules Hostname operator dropdown includes "is in list" / "is not in list" -->

- [ ] Is there a [changelog](https://developers.cloudflare.com/changelog/) entry ([guidelines](https://developers.cloudflare.com/style-guide/documentation-content-strategy/content-types/changelog/))? 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](https://developers.cloudflare.com/fundamentals/new-features/available-rss-feeds/), the [Discord](https://discord.com/channels/595317990191398933/1040420029080018945), and [X](https://x.com/CFchangelog).
- [x] The change adheres to the [documentation style guide](https://developers.cloudflare.com/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.
- [x] Files which have changed name or location have been allocated [redirects](https://developers.cloudflare.com/pages/configuration/redirects/#per-file).
@jayeve jayeve requested a review from a team as a code owner May 18, 2026 21:03
@github-actions github-actions Bot added product:cache Issues or PRs related to Cache size/s labels May 18, 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