[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
Open
Conversation
… 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).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.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:
/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/.Summary
Screenshots (optional)
Documentation checklist