Cloudimage - Documentation

Caching interval

Token caching settings

CDN caching accelerates the loading times of images as it allows to host them as close as possible to your end users. By using CDN caching, your ensure maximum performance of your website. You can define the max-age and s-maxage attributes in the Cache-Control HTTP Header of images delivered by Cloudimage to control the caching behavior.

When this cache expired, the image will be requested from the origin and the new image delivered to the client. Reduce the default values if you have rotating images but static image URLs without versioning.

We recommend using Invalidation if you need to refresh your images as it will not impact your CDN cache-hit ratio.

max-ageThe time in seconds that the image is allowed to be re-used.
For instance, max-age=36000 indicates that an image remains in the browser cache for the next 36 000 seconds (10 hours).
s-maxageThis directive applies only to the caching in CDN. To maximise performance,
we recommend you set a high value here and invalidate images when needed.

If you have rotating origin images but do not change the name, you need to follow the chart:

Setting default cache

You can set the desired values in the admin console, under Image Settings -> Caching.

Image caching settings

You can define the caching interval of a specific image by setting the ci_cache=X URL parameter of the image where X is the interval in seconds.


This will override the max-age and s-maxage attributes only for this image.

Automatic origin image refresh

Photo alt \#responsive

If you need to use a very small caching interval for a specific image (for example, snapshots from a live webcam or a specific chart with dynamically changing contents), you need to change the Automatic origin image refresh setting in your Admin console. This tells our resizing servers to update all origin images after this interval has expired.

Please note that the Automatic origin image refresh value affects all URLs using your token. This will not change your CDN cache but after this interval expires, the origin image will be fetched by our resizing servers from your storage on every new operation or filter.