Cookie Base Cache
Control CDN caching behavior by varying cache entries based on specific cookie values.
The Cookie Base Cache feature allows you to include selected cookies in the CDN cache key for Dynamic Content Acceleration resources.
By creating separate cache entries based on selected cookies, the CDN can safely cache personalized or session-aware content while maintaining cache efficiency.
This feature is available only for Dynamic CDN Resources.
How Cookie Base Cache Works
When Cookie Base Cache is enabled:
The CDN evaluates the configured cookie names for each request.
Matching cookies are incorporated into the cache key according to the selected Match Mode.
Requests that generate different cache keys are cached separately.
The selected Match Mode determines how requests are handled when the configured cookie is present, empty, or missing.
This allows dynamic content to be cached without serving incorrect responses between different users or application states.
Match Modes
Each configured cookie can use one of the following match modes.
Value Required
The cookie name and value are included in the cache key.
Requests with different cookie values generate separate cache entries.
Example
lang=tr
Cache A
lang=en
Cache B
Use this mode when the response content depends on the cookie value, such as language selection, localization, or customer-specific content.
Existence Only
The configured cookie is evaluated when generating the cache key. If the cookie contains a value, that value contributes to the cache key.
If the cookie contains a value, different cookie values generate separate cache entries. If the cookie is present but its value is empty, the request follows the default cache behavior. Requests that do not include the configured cookie bypass cookie-based cache variation.
Example
feature=true
Cache A
feature=false
Cache B
feature=(empty value)
Default Cache
Cookie not present
Bypass
Use this mode when requests should continue to participate in cookie-based caching even if the cookie value is empty, while requests without the cookie should bypass cookie-based cache variation.
Configure Cookie Base Cache
You can configure this feature from the Medianova Control Panel.
Best Practices
Use Value Required only when response content changes based on the cookie value.
Use Existence Only when requests containing the configured cookie should participate in cookie-based caching and requests without the cookie should bypass cookie-based cache variation.
Configure only the cookies required for cache variation.
Excessive cookie-based cache variations may reduce cache efficiency and increase cache fragmentation.
This feature modifies cache key generation only and does not bypass caching.
Combine with Disallow Cookie Base Cache when specific requests should bypass cookie-based cache variation.
Common Use Cases
Cache localized pages using language cookies.
Cache personalized HTML responses based on user state.
Separate authenticated and unauthenticated content.
Support feature flags or A/B testing using cookie-based cache variation.
Cache API or JSON responses that vary by session or application state.
Last updated
Was this helpful?
