Skip to main content
Watermarks composite a second raster on top of the transformed image — useful for brand marks, copyright notices, and preview protection. Pass a stored file ID or a public HTTPS image URL as watermark (alias mark).
Image with a bottom-right watermark
Watermark anchored top-left
Subtle centered watermark
Rotated watermark at center
Image with a tiled rotated watermark grid
Watermark with multiply blend mode

​
Parameters

ParamValueDefault
watermark (mark)Stored file ID or public HTTPS raster URL.—
markWWatermark width in pixels. Defaults to ~18% of final image width.auto
markScale (mark-scale)Scale watermark to a percentage of base image width (0–100). Overrides default width.auto
markRot (mark-rot)Rotate watermark counter-clockwise (0–359).0
markTile (mark-tile)Tile across the image. Valid value: grid.single mark
markOpacity (watermarkOpacity)Opacity (0.05–1) for single marks and tiled grids.0.78
markPositiontop-left, top-center, top-right, center, bottom-left, bottom-center, bottom-right.bottom-right
markPadMargin from the image edge in pixels.24
markBlendCompositing mode: over, multiply, screen, overlay, darken, lighten, etc.over
?w=1200&watermark=<stored-file-id>&markW=160&markOpacity=0.72&markPosition=bottom-right&markPad=28
?w=900&watermark=<stored-file-id>&markScale=18&markRot=30&markTile=grid&markOpacity=0.35
?w=1200&watermark=<stored-file-id>&markBlend=multiply&markScale=28&markPosition=center
Remote watermark URLs must resolve to a public address (SSRF-safe). SVG and non-image responses are rejected. Convertly ignores missing or invalid watermark references instead of failing the whole render. For alpha masks (clip the base image to a shape), see Canvas, trim & masks.