arrow-left

All pages
gitbookPowered by GitBook
1 of 14

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Caching

Edge Cache Expiration

Learn how Edge Cache Expiration determines caching behavior and freshness for dynamic content at CDN edge servers.

The Edge Cache Expiration feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It defines how the CDN caches objects at the edge and how long cached responses remain valid before refreshing from the origin. You can configure cache modes that rely on Panel-defined TTL values, defer to origin headers, or disable caching entirely for dynamic workloads.

For configuration details, cache modes, and examples, refer to the main documentation: Learn more in the.

Edge Cache Expiration documentation

Query String Caching

Learn how Query String Caching defines cache key behavior for dynamic URLs containing query parameters.

The Query String Caching feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It determines how the CDN evaluates query parameters when generating cache keys, allowing you to cache each query string variant separately, ignore specific parameters, or build cache keys using only selected values. These configurations provide granular control over caching behavior for dynamic endpoints, APIs, and personalized content.

For configuration details, caching modes, and examples, refer to the main documentation: Learn more in the .

Query String Caching documentation

Error Status Code Cache Expiration

Learn how Error Status Code Cache Expiration defines caching duration for error responses in dynamic workloads.

The Error Status Code Cache Expiration feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It allows you to define custom cache durations for specific HTTP error codes so the CDN can temporarily store repeated error responses, reducing unnecessary load on the origin. Each status code can have its own TTL, and caching can be enabled or disabled per code based on your requirements.

For configuration details, supported behaviors, and examples, refer to the main documentation: Learn more in the .

Error Status Code Cache Expiration documentation

Browser Cache Rule

Learn how Browser Cache Rules define how long dynamic content remains cached in the visitor’s browser.

The Browser Cache Rule feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It controls browser-side caching by defining cache duration, cache modes, and rule priorities for different URL patterns, directories, or file types. These rules determine how browsers store and revalidate dynamic content, independent of CDN edge caching behavior.

For configuration details, rule types, and examples, refer to the main documentation: Learn more in the .

Browser Cache Rule documentation

Etag Verification

Learn how ETag Verification ensures cached dynamic content remains consistent with the origin.

The ETag Verification feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It compares the ETag value returned by the origin with the ETag of the cached object and refreshes the cache when a mismatch occurs. This ensures the CDN serves the most up-to-date version of dynamic content and prevents stale objects from being delivered to end users.

For configuration details, validation behavior, and examples, refer to the main documentation: Learn more in the.

ETag Verification documentation

Header Base Cache

Control CDN caching behavior by varying cache entries based on specific HTTP request headers.

The Header Base Cache feature allows you to include selected HTTP request headers in the CDN cache key for Dynamic Content Acceleration resources.

This enables the CDN to create separate cached objects for different header combinations, ensuring correct delivery of dynamic or personalized content without disabling caching.

circle-info

This feature is available only for Dynamic CDN Resources.

hashtag
How Header Base Cache Works

When Header Base Cache is enabled:

  • The CDN inspects incoming requests for the configured HTTP header keys.

  • The specified headers and their values are included in the cache key.

  • Requests with different header values are cached as separate variants.

This approach allows safe caching of responses that vary based on request headers such as language, device hints, or custom application headers.

hashtag
Configure Header Base Cache

You can configure this feature from the .

1

Open the Caching Settings

Log in to the Medianova Control Panel, navigate to CDN → CDN Resources, select a Dynamic CDN Resource, and open the Caching tab.

2

Enable Header Base Cache

Set

  • Each unique header value creates a separate cache entry.

  • Header matching is based on the header name; values are evaluated dynamically.

  • This feature affects cache key generation, not cache bypass behavior.

hashtag
Common Use Cases

  • Cache responses per language using Accept-Language

  • Separate cache entries for feature flags or tenant identifiers

  • Cache dynamic HTML or JSON responses that vary by request metadata

Requests that do not include the configured headers follow the default cache behavior.
Status
to
On
.

The header input field becomes active.

3

Add Request Headers

Enter the header information:

  • Header Key — Name of the HTTP request header to include in the cache key

Select the + button to add additional header keys if required.

4

Apply the Configuration

Select Submit to save and apply the changes.

Adding too many headers may increase cache fragmentation and reduce cache efficiency.
  • Header Base Cache can be combined with Cookie Base Cache and Disallow Cookie Base Cache for advanced cache control strategies.

  • Support multi-tenant or region-aware applications
    Medianova Control Panelarrow-up-right

    Stale Cache

    Learn how Stale Cache enables serving previously cached dynamic content when the origin becomes temporarily unavailable.

    The Stale Cache feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It allows CDN edge servers to deliver the last cached version of an object when the origin fails to respond or returns specific error codes. You can define which origin conditions—such as timeouts, invalid headers, or 5xx errors—trigger stale delivery. This improves availability for dynamic workloads during short-term origin instability.

    For configuration details, supported triggers, and examples, refer to the main documentation: Learn more in the .

    Stale Cache documentation

    MNUID Cookie Base Cache

    Learn how to configure MNUID Cookie Base Cache for Dynamic CDN Resources to create session-aware cached content.

    MNUID Cookie Base Cache generates separate cached versions of content based on the MNUID cookie value for Dynamic Content Acceleration resources.

    This feature enables session-aware caching while maintaining control over cache lifetime through configurable expiry settings.

    circle-info

    This feature is available only for Dynamic CDN Resources.

    hashtag
    How MNUID Cookie Base Cache Works

    When MNUID Cookie Base Cache is enabled:

    • Medianova CDN checks incoming requests for the MNUID cookie.

    • The value of the MNUID cookie is included in the cache key.

    • Requests with different MNUID values are cached as separate variants.

    This mechanism allows session-aware caching while maintaining control over cache lifetime.

    hashtag
    Configure MNUID Cookie Base Cache

    You can manage MNUID Cookie Base Cache using the .

    1

    Open the Caching Settings

    Log in to the Medianova Control Panel, navigate to CDN → CDN Resources, select a Dynamic CDN Resource, and open the Caching tab.

    2

    Enable MNUID Cookie Base Cache

    Set Status to On.

    • Each unique MNUID value creates a separate cache entry.

    • Cache variation is based on the cookie value, not just its presence.

    • Cookie Expiry Time controls cache validity independently of origin headers.

    hashtag
    Common Use Cases

    • Cache dynamic pages per authenticated user session

    • Improve performance for logged-in users while maintaining correctness

    • Control cache lifetime for session-based personalization

    • Reduce origin load for frequently accessed user-specific content

    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. This ensures that different user sessions or states receive the correct cached response without disabling caching entirely.

    circle-info

    This feature is available only for Dynamic CDN Resources.

    hashtag
    How Cookie Base Cache Works

    When Cookie Base Cache is enabled:

    • The CDN inspects incoming requests for the configured Cookie Key values.

    • The specified cookies are included as part of the cache key.

    • Requests with different cookie values are cached separately.

    This allows dynamic and personalized content to be cached safely without serving incorrect responses across users.

    hashtag
    Configure Cookie Base Cache

    You can configure this feature from the .

    1

    Open the Caching Settings

    Go to CDN → CDN Resources, select a Dynamic CDN Resource, and open the Caching tab.

    2

    Enable Cookie Base Cache

    Set Status to On.

    • Each unique cookie value creates a separate cache entry.

    • Cookie matching is based on the cookie name only; values are evaluated dynamically.

    • This feature affects cache key generation, not cache bypass.

    hashtag
    Common Use Cases

    • Cache dynamic pages per user role or session type

    • Serve different cached responses for logged-in vs logged-out users

    • Safely cache HTML or JSON responses that depend on cookie state

    Mobile Device Cache

    Learn how Mobile Device Cache enables device-based caching for dynamic content delivery.

    The Mobile Device Cache feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It allows CDN edge servers to create separate cache entries based on the client’s device type, ensuring that mobile, tablet, and desktop users receive the correct version of dynamic content without cache conflicts.

    When enabled, the CDN also forwards device metadata to the origin using the X-DEVICE and X-MOBILE request headers. This enables device-aware logic at the origin while preserving cache integrity at the edge.

    Cache behavior, device classification logic, and forwarded headers remain consistent across Static Content Delivery and Dynamic Content Acceleration.

    For configuration steps, device categories, forwarded headers, and usage examples, refer to the main documentation: Learn more in the .

    Header Value Base Cache

    Control CDN caching behavior by allowing or denying cache based on specific HTTP header name–value pairs.

    The Header Value Base Cache feature allows you to explicitly allow or deny caching when a request contains a specific HTTP header value. This provides precise control over caching behavior for Dynamic Content Acceleration resources where certain header values determine whether content should be cached.

    circle-info

    This feature is available only for Dynamic CDN Resources.

    Mobile Device Cache documentation
    Cached responses remain valid for the duration defined in Cookie Expiry Time.
  • After the expiry time elapses, the cached content is refreshed from the origin.

  • 3

    Set the Cookie Expiry Time

    Enter the Cookie Expiry Time in seconds.

    This value defines how long cached content remains valid for requests that include the MNUID cookie.

    4

    Apply the Configuration

    Select Submit to save and apply the changes.

    Setting a very short expiry time may reduce cache efficiency.
  • This feature affects cache key generation, not cache bypass.

  • Can be combined with Cookie Base Cache and Header Base Cache for advanced session-aware caching strategies.

  • Medianova Control Panelarrow-up-right
    Requests without the configured cookies follow the default cache behavior.
    The cookie input field becomes active.
    3

    Define Cookies

    Enter the cookie name:

    • Cookie Key — Name of the cookie to include in the cache key

    Use the + button to add multiple cookie keys if required.

    4

    Apply the Configuration

    Select Submit to save and apply the changes.

    Use together with Disallow Cookie Base Cache for advanced session-aware caching strategies.
  • Adding too many cookies may increase cache fragmentation.

  • Medianova Control Panelarrow-up-right
    hashtag
    How Header Value Base Cache Works

    When Header Value Base Cache is enabled:

    • Medianova CDN inspects incoming requests for the configured Header and Value.

    • If the request matches the defined rule:

      • Allow — the response is eligible for caching.

      • Deny — the response bypasses the cache and is fetched from the origin.

    • Requests that do not match the rule follow the default caching behavior.

    This mechanism allows cache decisions to be enforced conditionally, rather than only by cache key variation.

    hashtag
    Configure Header Value Base Cache

    You can configure this feature from the Medianova Control Panelarrow-up-right.

    1

    Open the Caching Settings

    Log in to the Medianova Control Panel, navigate to CDN → CDN Resources, select a Dynamic CDN Resource, and open the Caching tab.

    2

    Enable Header Value Base Cache

    Set Status to On.

    3

    Select the Rule Type

    Choose the behavior for matching requests:

    • Allow — matching requests are cached

    • Deny — matching requests bypass the cache

    4

    Define the Header Rule

    Enter the rule parameters:

    • Header — Name of the HTTP request header

    • Value — Header value to match

    5

    Apply the Configuration

    Select Submit to save and apply the changes.

    • Only one header value-based rule can be active at a time.

    • Header matching is exact; both header name and value must match.

    • This feature controls cache eligibility, not cache key variation.

    • Can be combined with Header Base Cache and Cookie Base Cache for advanced caching strategies.

    • Incorrect use of Deny may significantly reduce cache hit ratio.

    hashtag
    Common Use Cases

    • Prevent caching when a request contains a debug or preview header

    • Allow caching only when a specific feature-flag header is present

    • Enforce cache bypass for internal or authenticated traffic

    • Control caching behavior based on application-specific headers

    Shared Cache

    Learn how Shared Cache defines whether dynamic content is cached independently or shared across accounts.

    The Shared Cache feature for Dynamic Content Acceleration operates the same way as in Static Content Delivery. It determines whether CDN edge nodes use an isolated cache namespace for your account (Default) or a shared cache namespace across multiple accounts that use the same Domain Cache Key (Share). When shared mode is enabled, identical content is cached once and reused across participating accounts, improving efficiency and reducing redundant origin requests.

    For configuration details, cache modes, and examples, refer to the main documentation: Learn more in the .

    Shared Cache documentation

    Disallow Cookie Base Cache

    Control CDN caching behavior by excluding requests that contain specific cookie values.

    The Disallow Cookie-Based Cache feature allows you to bypass CDN caching for requests that include defined cookie key–value pairs. This ensures that personalized or session-based content is always fetched from the origin instead of being served from cache.

    Use this feature to prevent incorrect caching of dynamic responses while maintaining optimal cache efficiency for all other traffic.

    circle-info

    This helps you avoid caching personalized or session-based responses on Dynamic Content Acceleration resources.

    hashtag
    How Disallow Cookie-Based Cache Works

    When the feature is enabled:

    • The CDN inspects incoming requests for the configured cookie key–value pairs.

    • If any defined pair matches, the request bypasses the cache.

    • The response is fetched directly from the origin and is not stored in the CDN cache.

    This behavior applies consistently across all requests for the selected CDN Resource.

    hashtag
    Configure Disallow Cookie-Based Cache

    You can configure this feature from the .

    1

    Enable the Feature

    In the Caching tab of your Dynamic CDN Resource, set Disallow Cookie-Based Cache to On.

    The cookie rule inputs become available.

    2

    Define Cookie Rules

    • Cache bypass is triggered if any defined cookie rule matches.

    • Cookie matching is exact; both key and value must match.

    • This feature affects cache eligibility only and does not modify headers or routing logic.

    hashtag
    Troubleshooting

    Issue: Responses are still cached. Cause: The incoming cookie value does not exactly match the configured key-value pair. Fix: Capture the request cookies from the client and confirm the exact key and value.

    Issue: Cache hit ratio drops unexpectedly. Cause: Too many cookie pairs are configured, or a widely present cookie is included. Fix: Remove non-essential cookies and keep only cookies that must bypass cache.

    Issue: Configuration does not take effect. Cause: Changes were not saved. Fix: Confirm you selected Submit and re-check the setting state in the Caching tab.

    Requests that do not match any configured cookie rules continue to follow normal caching logic.
    Enter the cookie details:
    • Cookie Key — Name of the cookie to match

    • Cookie Value — Value that triggers cache bypass

    Select + to add additional cookie rules if required.

    3

    Save changes

    Select Submit to save and apply the changes.

    Requests that do not include matching cookies continue to benefit from CDN caching.
  • Use carefully together with to avoid unintended cache bypass.

  • Medianova Control Panelarrow-up-right
    Page Rules