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.
Upload your default watermark using the uploader.
Step 2 - start watermarking!
Static watermark example
/sample.li/tesla.jpg?w=250&wat=1&wat_gravity=southwest&wat_scale=30&wat_pad=8
| 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.
Northeast, padding: x=10, y=8
/sample.li/earth1.jpg?w=250&
h=156&wat=1&wat_scale=30&wat_gravity=northeast&wat_pad=10,8
North, padding: x=0%, y=5%
/sample.li/ny_doc.jpg?w=250&wat=1&wat_scale=50&wat_gravity=north&wat_pad=0p,4p
Original watermark
//sample.li/Cloudimage_logo_white_h.png
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
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
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
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
The watermark is resized to exactly 30% of the output image size.