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.

Text watermark

If you need to tag an image or add a reference number on an image, use the text watermark.

Example

/sample.li/flat1.jpg?w=550&wat=1&wat_gravity=northeast&wat_text=REF00189300B&wat_pad=10&wat_font=Arial-Black&wat_fontsize=18&wat_colour=660000

Options

optionsyntax
use watermarkwat=1
required
watermark textwat_text=X
watermark positionwat_gravity=X
X = [north-south][east-west]
watermark paddingwat_pad=X[p][,Y[p]]
X,Y - in pixels
Xp,Yp - in percent
watermark opacitywat_opacity=X
X = 0..1
watermark font familywat_font=X
the full list of available fonts can be found here
watermark text colourwat_colour=X | wat_color=X
X - hexadecimal code or colour name
watermark font sizewat_fontsize=X
wat_fontsize=Xmax
X - set exact font size
Xmax - set maximum font size

Limit font size

Instead of setting an exact font size, you can set a maximum font size. In this case, font size will be reduced if the watermark cannot fit in the image.