Getting Started

Filestack Architecture

File Upload

File Export (Save To)

Responsive Images

Image Transformations

Document Transformations

Video Transcoding

Audio Transcoding





Filestack Viewer


Supported Cloud Drives

Filestack Recipes

Filestack Integrations

Filestack SDKs

Register for an API key

Image Transformations - Watermark

You can add watermarks to images by overlaying another image on top of your main image.


Filestack has a limit to how large the images it will accept for conversions can be. The maximum accepted image size is 100,000,000 pixels, so an image with this many pixels could have width and height combinations like 10,000 x 10,000 or 5,000 x 20,000, etc. There is also a file size restriction. Filestack will not process an image that is larger than 256mb. Please contact us if you require the ability to process larger files than our current limits.

watermark=file:VsXhJVWReSrYU7UoFyfw The Filestack handle of the image that you want to layer on top of another image as a watermarkto resize the image to.This parameter can be abbreviated to f:VsXhJVWReSrYU7UoFyfw
watermark=size:75 The size of the overlayed image as a percentage of its original size. The value must be an integer between 1 and 500. This parameter can be abbreviated as s:75.
watermark=position:top, middle, bottom, left, center, or right The position of the overlayed image. Possible values for position are: top, middle, bottom, left, center, and right. These values can be paired as well like position:[top,right]. This parameter can be abbreviated as p:top.

Watermark Examples

Original Image

original photo to have watermark applied to it using Filestack's image transformations

Image with watermark using default settings (center position with a size of 100%). It is always best to use high quality images for watermarking:

image with watermark added using default settings

Image with watermark using the default center position and a size:300:

image with watermark added and size increased to 300%

Image with watermark using a top right position and a size of 200%, position:[top,right],size:200:

image with watermark added to top right and watermark size set to 200%