Media cache settings
On this page
There are 3 types of cache in Amplience:
- Browser Cache
- Mid-tier CDN Cache
- Edge CDN Cache
Browser cache
Tells the browser how long to cache loaded files for. This is best for performance as the browser will not attempt to request the file from Amplience, but you do not have any business control over this cache.
Available settings levels:
- Account level
- Template level ( only available when removed from account level )
Minimum browser cache in seconds: 30
Feature | Parameter | Description |
---|---|---|
Browser cache | h-ttl | The time a successful media request is cached in your browser for in seconds. |
Browser error cache | h-e-ttl | The time a failed media request is cached in your browser for in seconds. |
While extended browser caching can have an increase in repeat view performance, it does also lose business control of the media. Amplience can clear the cache on our CDN architecture, but we have no access to the browser cache.
Template level browser cache settings
If you choose to remove your account level settings for browser cache, there are a few things to note:
- If no settings are provided in TT's, the system will default to 30 minutes.
- There is no maximum browser cache setting. However, please note the warning above.
This abides by the normal Dynamic Media rules (the last instance of the same parameter in a URL request wins). For example, if you had 2 templates. $tt1$ and $tt2$, where $tt1$ had a browser cache of 1 hour and $tt2$ had a browser cache of 2 hours, the actual browser cache would depend on the order in the URL:
https://cdn.media.amplience.net/i/myaccount/myasset.jpg?$tt1$&$tt2$
- would give you 2 hourshttps://cdn.media.amplience.net/i/myaccount/myasset.jpg?$tt2$&$tt1$
- would give you 1 hour.
Mid Tier CDN cache
This is not configurable. This tier is automatically purged when new content has been published.
Edge CDN Cache
This setting tells our Edge CDN networks how long to cache files for before requesting the latest version on the Mid Tier CDN:
Available settings levels:
- Account level
Minimum Edge CDN cache in seconds: 86400 (24 hours).
Feature | Parameter | Description |
---|---|---|
Edge CDN Cache | h-s-ttl | The time a successful media request is cached in on the Amplience Edge CDN. |
Edge CDN error cache | h-e-s-ttl | The time a failed media request is cached in on the Amplience Edge CDN. |
For any requests for settings outside of these bounds, please contact your Customer Success Manager to discuss it.
Advanced Media Cache Settings
You can set browser and edge CDN TTLs for specific media types from Amplience. These will override any settings mentioned above.
Available settings levels:
- Account level
Feature | Parameter | Description |
---|---|---|
Image Meta Data Edge CDN Cache | h-s-ttl-im | The meta data response when requesting images from the Amplience platform |
Image Meta Data Edge CDN Error Cache | h-e-s-ttl-im | |
Image Meta Data Edge Browser Cache | h-ttl-im | |
Image Meta Data Edge Browser Error Cache | h-e-ttl-im | |
Set Meta Data Edge CDN Cache | h-s-ttl-set | The meta data response when requesting sets from the Amplience platform |
Set Meta Data Edge CDN Error Cache | h-e-s-ttl-set | |
Set Meta Data Edge Browser Cache | h-ttl-set | |
Set Meta Data Edge Browser Error Cache | h-e-ttl-set | |
Template Meta Data Edge CDN cache | h-s-ttl-tpl | The meta data response when requesting template information from the Amplience platform |
Template Meta Data Edge CDN Error Cache | h-e-s-ttl-tpl | |
Template Meta Data Edge Browser Cache | h-ttl-tpl | |
Template Meta Data Edge Browser Error Cache | h-e-ttl-tpl | |
Video Meta Data Edge CDN Cache | h-s-ttl-vm | The meta data response when requesting videos from the Amplience platform |
Video Meta Data Edge CDN Error Cache | h-e-s-ttl-vm | |
Video Meta Data Edge Browser Cache | h-ttl-vm | |
Video Meta Data Edge Browser Error Cache | h-e-ttl-vm |