Cloudimage - Documentation

Accounts created before Nov. 1st, 2021

Accounts created before November 1, 2021 have to include /v7/ in the path, like shown below.

//token.cloudimg.io/v7/original_image_url?operations&filters

Accounts created on or after November 1, 2021 do not require /v7/ and documentation have been updated accordingly.
To verify the type of configuration on your Cloudimage account, log in to your Cloudimage admin panel and look at the syntax provided on the Welcome page.

[NOTE] If you are an existing Cloudimage customer and wish to be able to remove the v7 from your URL syntax, please contact our support.

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.

directive description
max-age The 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-maxage This 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.

Photo alt \#responsive

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.

/sample.li/now.php?ci_cache=10

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.