Documentation

Help & Knowledgebase

Watermarking

We offer 3 kind of watermarking:

  • static watermarking: the same watermark is applied to all of your images
  • dynamic watermarking: different images can have different watermarks
  • dynamic watermarking with text: generate a dynamic text watermark

Static Watermarking

Step 1: Login to your admin console and browse to Token > Watermark. Upload your watermark image in your dashboard



We recommend to use a transparent PNG as watermark.

Step 2: Enable watermark option in your URL
Just add the watermark options in the options: https://demo.cloudimg.io/width/500/fwk.wpossoutheast.wscale40.wpad10/http://sample.li/boat.jpg

Step 3: Enjoy your fancy watermark!

Static watermark options
Parameter Values Description
fwk Enable watermark
wpos [south|north][east|west] Position of the watermark (example. southwest)
wpad 0 .. 500 Padding between the edge of the watermark and the edge of the image
wscale 0 .. 100 Rescale the watermark image (10% : 10% of the original image)
One more example

Just copy paste this URL and play with it: https://demo.cloudimg.io/height/400/fwk.wpossoutheast.wpad10.wscale30/sample.li/boat.jpg

Dynamic Watermarking

With Dynamic Watermarking, you can specify the Watermark URL in the Cloudimage URL. Unlike other Cloudimage parameters, these parameters are passed at the end of your URL. You will find the parameters and few examples below.

Dynamic watermark options
Parameter Values Description
&mark_url= URL of an image (can be url-encoded) Image of the watermark
&mark_alpha= 0 .. 100 Opacity of the watermark (100 = opaque)
&mark_pos= [south|north][east|west] Position of the watermark (example. southwest)
&mark_size= 0 .. 100% Rescale the watermark image (10% : 10% of the original image)
&mark_pad= 0 .. 100 Adds padding from the corner (in pixels)
&mark_height= 0 .. 100 Optional Final height of the watermark
&mark_width= 0 .. 100 Optional Final width of the watermark
Example

https://demo.cloudimg.io/width/500/n/sample.li/voyage-louis-vuitton.jpg?v&mark_url=http://sample.li/louis-vuitton-logo-white.png&mark_width=45&mark_pos=southwest&mark_pad=15


Dynamic Watermarking with Text

This watermarking allows you to add any text to and image as a watermark. This is useful to add a reference number to an image. See the examples below.

Dynamic watermark - Text options
Parameter Values Description
&mark_text= Text Text of the watermark
&mark_pos= [south|north][east|west] Position of the watermark (example. southwest)
&mark_fontsize= 5 .. 100 Font size
&mark_color= Hexa value without # Font color
&mark_font= Arial, Courier-Bold, Helvetica... Font family
&mark_pad= 0 .. 100 Adds padding from the corner (in pixels)
Example

https://demo.cloudimg.io/width/600/fwk/http://sample.li/flat1.jpg?mark_text=REF00189300B&mark_pos=northeast&mark_color=FF0033&
mark_fontsize=20&mark_pad_x=10&mark_pad_y=10&mark_font=Arial