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.

Static Watermark

This filter will watermark all your images with the same watermark. This is useful for placing your company logo, name or other copyright information. If you would like to watermark different images with different watermarks, please refer to the dynamic watermark section.

Step 1 - upload your default watermark in the Cloudimage admin console

Log in to your Cloudimage admin console a navigate to Image Settings / Watermark.

Photo alt \#responsive

Upload your default watermark using the uploader.

Step 2 - start watermarking!

option syntax
use watermark wat=1
required
watermark position wat_gravity=X
X = [north-south][east-west]|center
watermark scaling
(relative to original watermark size)
wat_scale=X
X = 0..100 - in percent
watermark scaling
(relative to output image size)
wat_scale=Xp
X = 0p..100p - in percent
watermark padding wat_pad=X[p][,Y[p]]
X,Y - in pixels
Xp, Yp - in percent
watermark opacity wat_opacity=X
X = 0..1

Watermark position

The wat_gravity option sets the position of the watermark and the wat_pad defines the offset of the watermark from the gravity position.

Available wat_gravity values

northwest north northeast
west centre | center (default) east
southwest south southeast

The padding can be defined in pixels (wat_pad=X[,Y]) or in percent of output size (wat_pad=Xp[,Yp]). The padding is applied after scaling the final image and then it is compressed (see Compression) and delivered via CDN.

Watermark size

The watermark can be scaled relative to the original watermark image (wat_scale=X[,Y]) or relative to the output image (wat_scale=Xp[,Yp]).

Original watermark

//sample.li/Cloudimage_logo_white_h.png

Photo alt \#responsive

Here, the watermark image is 1832 px wide.

Watermarked scaled relative to the watermark image

/sample.li/tesla.jpg?w=1200&wat=1&wat_gravity=southwest&wat_scale=30&wat_pad=15

Photo alt \#responsive

The watermark is scaled down to 30% of its original width (550 px) and embeeded in the image. Then, the final image is scaled down to 1200-px width.

If the final image is scaled with width and/or height, the watermark is further scaled along with the image:

Smaller image

/sample.li/tesla.jpg?w=250&wat=1&wat_gravity=southwest&wat_scale=30&wat_pad=8

Photo alt \#responsive

The same image as the one on the left but with a different final size.

Note that the watermark is scaled down with the image but the padding is the same.

Original watermark

//sample.li/Cloudimage_logo_white_h.png

Photo alt \#responsive

Here, the watermark image is 1832 px wide.

Watermark scaled relative to the output image

/sample.li/tesla.jpg?w=1200&wat=1&wat_gravity=southwest&wat_scale=30p&wat_pad=15

Photo alt \#responsive

The watermark is resized to exactly 30% of the output image size.