For the complete documentation index, see llms.txt. This page is also available as Markdown.

Query String Caching

Control how query strings affect CDN cache behavior for dynamic or parameterized URLs.

Query String Caching determines whether requests with different query strings create separate cached objects or map to the same cached object. You can also exclude specific parameters from the cache key or build the cache key using only selected parameters.

You can manage Query String Caching in the Medianova Control Panel or via the API.

Query String Caching Modes

Select one of the following modes:

Mode
Behavior

On

Each unique query string combination creates a separate cached variant.

Off

Query strings are excluded from the cache key. URL variations with different query strings map to the same cached object.

Request URI

Uses the full request URI, including query parameters, as the cache key.

Configure Query String Caching

1

Open Query String Caching

Open your CDN Resource and select Caching.

Locate Query String Caching.

2

Select the Caching Mode

Select On, Off, or Request URI according to the required cache-key behavior.

3

Configure Parameter Filtering

If required, use one of the additional query string controls:

  • Ignore Specific Query Strings – Excludes selected query parameters from the cache key. These parameters do not create separate cached variants.

  • Cache Specific Query Strings Only – Builds the cache key using only selected query parameters and ignores all other parameters.

Use parameter filtering for query parameters that should not independently identify cached content. For example, non-content parameters such as tracking parameters can be excluded when they do not affect the response returned by the origin.

4

Save the Configuration

Select Save in the pending changes bar.

Review the pending changes and confirm the update to apply the configuration to the CDN Resource.

Cache Key Behavior

Query String Caching directly affects how many cached variants can be created for the same URL.

With On, different query string combinations are cached independently. This preserves parameter-specific responses but can increase the number of cached objects.

With Off, query parameters do not differentiate cached objects. Requests for the same URL path therefore use the same cache entry regardless of their query strings.

With Request URI, the complete request URI, including query parameters, is used when constructing the cache key.

The additional filtering options provide more granular control:

  • Ignore Specific Query Strings removes selected parameters from cache-key evaluation.

  • Cache Specific Query Strings Only includes only selected parameters in cache-key evaluation and ignores the remaining parameters.

Caching every query string combination can reduce cache efficiency when URLs contain parameters that do not change the response. Excluding non-essential parameters can reduce unnecessary cache variants.

Last updated

Was this helpful?