Create an eCDN Cache Rule

Create a cache rule to make HTML pages and JSON responses eligible for caching at the eCDN edge for your B2C Commerce storefront. By default, eCDN caches only static content based on file extension.

A cache rule makes an otherwise-uncacheable content type eligible for caching, but it doesn't force caching. For a response to be cached, your origin must still return appropriate Cache-Control (or Expires) response headers. For details about how eCDN decides what to cache, see eCDN Cache Rules and Cache Purge.

Note Cache rules aren't available for SCAPI zones, where caching is platform-managed.

1. In Business Manager, click App Launcher , and then select Administration | Sites | Embedded CDN Settings.
2. Locate the zone that you want to configure, and select Configure Zone from the dropdown menu.
   
3. Open the Cache Rules section.
   
4. Click Add Rule, and then complete the rule fields.

   Complete the required fields.

   • Description: A human-readable label for the rule.
   • Expression: The match condition (maximum 4,096 characters). Supports fields such as http.request.uri.path, http.request.uri.path.extension, http.host, http.cookie, and ssl.
   • Action: Only cache is supported, which marks matching content as eligible for caching.

   Complete the optional fields as needed.

   • Enabled: Turns the rule on or off without deleting it. Selected by default.
   • Exclude query strings: The query parameters to exclude from the cache key (for example, gclid and utm_campaign).
   • Ignore query string order: Sorts query parameters alphabetically so that ordering variations hit the same cache entry. Deselected by default.
   • Respect strong ETags: Honors strong ETag validators from the origin. Deselected by default.
   • Position: Places this rule before or after another rule to control precedence. By default, the rule is added at the end.
   
5. Order rules as needed. When multiple rules match a request, the last matching rule takes effect.
6. Save the rule.

   The rule applies at the eCDN edge for that zone.

   

Example Cache Rule Expressions

To cache PWA Kit product detail pages (HTML), use this expression. Recommended options: exclude gclid and utm_campaign, ignore query string order, and respect strong ETags.

(http.request.uri.path matches ".*/product/[^/]+/?$" and http.request.uri.path.extension eq "html")

To cache SFRA content and marketing pages (HTML), use this expression.

((http.request.uri.path contains "/content/" or http.request.uri.path contains "/campaigns/") and http.request.uri.path.extension eq "html")