From be916c89a7105f037ae9a092b6e829b493f44163 Mon Sep 17 00:00:00 2001 From: Tim Kelty Date: Tue, 2 Jun 2026 07:23:35 -0400 Subject: [PATCH] Fix Cloud static cache cookie key docs --- docs/cloud/static-caching.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cloud/static-caching.md b/docs/cloud/static-caching.md index 287b2e3fe..817f47e43 100644 --- a/docs/cloud/static-caching.md +++ b/docs/cloud/static-caching.md @@ -160,7 +160,7 @@ cache: - message - pattern: /referral # Cache based on unique values for an `AD_SOURCE` cookie: - session: + cookies: - AD_SOURCE - REFERRER_NETWORK - pattern: / @@ -177,15 +177,15 @@ Cloud uses the first rule that matches, so you should declare them with _descend Note that customizing `query-string` _replaces_ our default behavior and [exclusion list](#ignored-params). ::: -Each `pattern` uses the same URL matching logic as [rewrites and redirects](redirects.md), and must define at least a `query-string` or `session` key. +Each `pattern` uses the same URL matching logic as [rewrites and redirects](redirects.md), and must define at least a `query-string` or `cookies` key. - **Query String** (`query-string`) — Two nested keys are required: - `mode` — Determines the behavior for this rule. `include` treats the provided `keys` as an allow-list; `exclude` treats it as a deny-list. - `keys` — The query string keys that are used as a mask for the chosen `mode`. -- **Cookies** (`session`) — Directly nest a list of strings corresponding to cookie names that should be incorporated into the cache key. There is no `mode` for cookie settings; when a key is provided _and present in a client’s request_, it is added to the cache key. Otherwise, cookies are ignored. +- **Cookies** (`cookies`) — Directly nest a list of strings corresponding to cookie names that should be incorporated into the cache key. There is no `mode` for cookie settings; when a key is provided _and present in a client’s request_, it is added to the cache key. Otherwise, cookies are ignored. -In both cases, keys _and their values_ are ultimately used to build cache keys—so pages matching the `session` rule above would be cached uniquely for clients with different `AD_SOURCE` cookie values. -You can combine `query-string` and `session` masks in a single rule for additional granularity. +In both cases, keys _and their values_ are ultimately used to build cache keys—so pages matching the `cookies` rule above would be cached uniquely for clients with different `AD_SOURCE` cookie values. +You can combine `query-string` and `cookies` masks in a single rule for additional granularity. The default behavior can be represented as a catch-all rule, like this: