use watermark
wat=1
(required) Activates the watermark function
watermark URL
wat_url=X
(required) The URL of the watermark image. Can be URL-encoded
watermark position
wat_gravity=X
X=[north|south][east|west]|center
Defines the position to "anchor" the watermark to
watermark scaling (relative to original watermark size)
wat_scale=X
X=0..100
Watermark image scaling defined in in percent of the watermark dimensions
watermark scaling (relative to output image size)
wat_scale=Xp
X=0..100p
Watermark image scaling defined in in percent of the output image dimensions
watermark padding
wat_pad=X[p][,Y[p]]
X/Y=0..100[p]
Adds padding from the anchoring point in pixels (X) or in percent (Xp)
watermark opacity
wat_opacity=X
X=0..1
Defines watermark opacity
use watermark | wat=1 | (required) Activates the watermark function |
watermark text | wat_text=X | (required) The text to be overlayed. Can be URL-encoded |
watermark position | wat_gravity=X
| Defines the position to "anchor" the watermark to |
watermark padding | wat_pad=X[p][,Y[p]]
| Adds padding from the anchoring point in pixels (X) or in percent (Xp) |
watermark opacity | wat_opacity=X
| Defines watermark opacity |
watermark font | wat_font=X | Choose the font family for the overlay |
watermark color | wat_color=X | wat_colour=X | Sets the text color |
watermark font size | wat_fontsize=X | wat_fontsize=Xmax | Sets the font size. If the Xmax syntax is used, the size is reduced if the text cannot fit in the image |
Text too long for the image: |
Text size limit set with wat_fontsize=20max: |
Statically defined image overlay
This function will watermark selected images with the same watermark - an image set in the Asset Hub. 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.
Log in to your Filerobot Asset Hub and navigate to Settings / Process -> Images / Watermark and upload your default watermark using the uploader.
To activate the watermark function, you need to include the wat=1 parameter.
The wat_gravity option sets the position of the watermark (available values are east, northeast, north, northwest, west, southwest, south, southeast, and center/centre) and the wat_pad defines the offset of the watermark from the gravity position.
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.
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]).
To keep the watermark-to-image proportions for all image resizes, you should use the wat_scale=Xp[,Yp].
| Parameter | Syntax | Description |
|---|---|---|
| Preview | Syntax |
|---|---|
use watermark
wat=1
(required) Activates the watermark function
watermark position
wat_gravity=X
X=[north|south][east|west]|center
Defines the position to "anchor" the watermark to
watermark scaling (relative to original watermark size)
wat_scale=X
X=0..100
Watermark image scaling defined in in percent of the watermark dimensions
watermark scaling (relative to output image size)
wat_scale=Xp
X=0..100p
Watermark image scaling defined in in percent of the output image dimensions
watermark padding
wat_pad=X[p][,Y[p]]
X/Y=0..100[p]
Adds padding from the anchoring point in pixels (X) or in percent (Xp)
watermark opacity
wat_opacity=X
X=0..1
Defines watermark opacity
Watermark scaled down to 45% of its original size (660px), results in 297px watermark: /docs/tesla.jpg?w=1200&wat=1&wat_gravity=southwest&wat_scale=45&wat_pad=15
Watermark scaled relative to the output image dimensions (540px watermark): /docs/tesla.jpg?w=1200&wat=1&wat_gravity=southwest&wat_scale=45p&wat_pad=15
Compose image or text layers over the main image
Filerobot can place a watermark on top of your images if you want to protect them from copying, or tag them with a serial number or custom text. There are three types of watermarks - click on each one for more details.
This is a beta feature, please contact our support to activate it for your token
You can overlay multiple watermarks by indexing the parameters in the URL wat[1]=1&wat[2]=1. The wat=1 parameter must be indexed and contain all watermarks to activate the feature.
All parameters without indices will be applied to all watermarks in the image.
?wat[1]=1&wat[2]=1&wat_scale[1]=50&wat_scale[2]=10&wat_opacity=0.5
In the above fragment, wat_opacity=0.5 will be applied to both watermarks.
Combining multiple watermark types is also possible. Remember that the presense of wat_url=X parameter defines a dynamic watermark, wat_text=X defines a text watermark and the absence of either defines a static watermark.
?wat[1]=1&wat[2]=1&wat[3]=1&wat_url[2]=sample.li/Angular.png&wat_text[3]=text
In the above fragment, there are three watermarks. Watermark 2 is a dynamic watermark, watermark 3 is a text watermark and watermark 1 is a static one.
Apply the same image watermark to all the images you decide to watermark (e.g. your company's logo). |
Specify the watermark in the Filerobot URL to apply different watermarks to different images. |
If you need to tag images, use the text watermark to dynamically embed text to the images you need tagged. |
