Watermark - Image

Watermarked image transformations can be done in two ways:-

Providing dynamic watermark options such as watermark image, placement, etc as URL parameters
Using the pre-defined watermark options already setup in the user's account settings

Watermark option can be combined with all other transformation options such as resize, crop, etc.

Using dynamic watermark options

watermark={watermark_image},{x},{y}{opacity},{width_scale},{height_scale}

Generate a watermarked image transformation by providing all the watermark options as URL parameters. This method allows you to apply different watermarks for the same image depending on the use case.

Parameter	Description
`watermark_image`	Watermark image URL such as `<http://www.example.com/logo.png>`
`x`	Horizontal watermark position starting at left: integer like `0 or 10` - negative value such as `-0` will start placement at right, `center` - places watermark in the center, `repeat` - repeats the watermark horizontally
`y`	Vertical watermark position starting at top : integer like `0 or 10` - negative value such as `-0` will start placement at bottom, `center` - places watermark in the center, `repeat` - repeats the watermark vertically
`opacity`	watermark image transparency, `0` is fully opaque, `100` is fully transparent, other integer values in between to alter opacity
`width_scale`	(optional) percentage of the width of the image the watermark should fit-in. For example `20` would scale the watermark to fit within 20% of the image's width. Note: watermark aspect ratio will be preserved
`height_scale`	(optional) percentage of the height of the image the watermark should fit-in

Examples

Uses FileSpin logo as watermark and places it to the bottom right of the image. Watermark image is used with the original size. Note the use of-0,-0 to place the watermark at the bottom right of the image.

watermark=API_HOST/static/img/logo.png,-0,-0,0

The complete URL would look like:-
https://cdn.filespin.io/api/v1/assets/0c3c6d026858460abc4de1dcb4de15ac/conversions?resize=1200,1200&watermark=https://app.filespin.io/static/img/logo.png,-0,-0

Use FileSpin logo as watermark and places it to the right top of the image. Watermark takes 40% of the image's width and height and opacity is 0 for fully opaque watermark.

watermark=API_HOST/static/img/logo.png,-0,0,0,40,40

The complete URL would look like:-
https://cdn.filespin.io/api/v1/assets/0c3c6d026858460abc4de1dcb4de15ac/conversions?resize=1200,1200&watermark=https://app.filespin.io/static/img/logo.png,-0,0,0,40,40

Use FileSpin logo as watermark and repeats it horizontally at the bottom. Watermark takes 40% of the image's width and height.

watermark=API_HOST/static/img/logo.png,repeat,-0,0,40,40

Using User's default watermark

watermark=https://app.filespin.io/api/v1/user/watermark/{USER_ID},0,0,0

Where {USER_ID} should be replaced with the user's ID. Note that {user.API_HOST}/api/v1/user/watermark/{USER_ID} is accessible publicly.

This option applies the watermark setup in the user's account settings.

Using dynamic watermark options​

Using User's default watermark​

Using dynamic watermark options

Using User's default watermark