Text watermark

Apply text overlay

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

Available parameters

Parameter	Syntax	Description
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 gravity	wat_gravity=X X=[north|south][east|west]|center| absolute|relative	Defines the position to "anchor" the watermark to
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 position	wat_pos=X[,Y]	sets the position in percent from the resized image; works only with wat_gravity=absolute and wat_gravity=relative
watermark opacity	wat_opacity=X X=0..1	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

Examples

Preview	Syntax
	/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_color=660000
	Text too long for the image: /sample.li/flat1.jpg?w=400&wat=1&wat_gravity=north&wat_text=A%20VERY%20LONG%20TEXT%20WHICH%20WON%27T%20FIT&wat_pad=10&wat_font=Arial-Black&wat_fontsize=20&wat_color=000
	Text size limit set with wat_fontsize=20max: /sample.li/flat1.jpg?w=400&wat=1&wat_gravity=north&wat_text=A%20VERY%20LONG%20TEXT%20WHICH%20WON%27T%20FIT&wat_pad=10&wat_font=Arial-Black&wat_fontsize=20max&wat_color=000