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.

Custom transformation presets

If you wish to apply the same transformations on many images, you can define presets and apply transformations only using the preset name (X).

p=X

Any resizing transformation or image filter can be included in a preset, as well as watermarks and image compression parameters.

Defining presets

You can define your presets in the admin panel, Image Settings / Presets.

Photo alt \#responsive

Using presets

Sample presets

preset nameoperations and filters
gallery_thumbw=250&h=250&f=gray
gallery_mediumw=450&h=300&force_format=jpeg&q=85&radius=10
gallery_largew=1200&force_format=jpeg&optipress=2&wat=1&wat_gravity=northwest&wat_scale=60&wat_pad=20&wat_opacity=0.4

Here are a couple of images using the sample presets shown above.

Large image, watermarked, JPEG w/ Optipress optimisation

/sample.li/birds.jpg?p=gallery_large

Photo alt \#responsive

Extending presets

You can use additional operations together with a preset. Here is an example:

preset nameoperations and filters
red_ref_numberw=400&h=200&wat=1&wat_gravity=northeast&wat_pad=10&wat_font=Arial-Black&wat_fontsize=18&wat_colour=660000

An operation defined in any given preset cannot be overridden in the URL. For example, if a preset named small_img contains w=200, using /original_image_url?p=small_img&w=400 will still yield a 200-pixel-wide image.