Watermark action
21. May 2026
The watermark modification applies an image overlay. You need to store your watermark image (PNG, GIF, TIFF) on an absolute path on the server. Then you can define a distance from the four borders in pixels (margin-left, margin-top, margin-right, margin-bottom). You can leave the margins empty. You must set the opacity (0.1 to 1) used for transparency and an aspect ratio - the ratio of the width of a shape to its height (e.g., 8:5, 16:10, and 1.6:1 are the same aspect ratio).
| Property | Value | Details |
|---|---|---|
| kind | WatermarkAction |
|
| watermarkFilePath |
Contact Fotoware Support to save on this path. The path does not need to be provided; only the file name is required, e.g., f |
Identifies the image to be used as a watermark. Portrait orientation to match the final image's size, based on the final image's size |
| marginLeft | Can be null, in Pixel | Margin to the left border of the image, in pixels. |
| marginTop | Can be null, in Pixel | Margin to the top of the image, in pixels. |
| marginRight | Can be null, in Pixel | Margin to the right border of the image, in pixels. |
| marginBottom | Can be null, in Pixel | Margin to the bottom of the image, in pixels. |
| opacity |
A number in the range 0-100, although everything larger than 1 is no opacity at all Choose a value between 0.1 and 0.9. |
Scales the opacity of the watermark. |
| widthRatio |
A number larger than 0, 0 is forbidden e.g., 0.5 for half the size or 2 for double the size |
Scales the watermark width according to the size of the final image. The widthRatio is used for portrait orientation. Use a square watermark file to ensure better-proportioned results. |
| heightRatio |
A number larger than 0, 0 is forbidden e.g., 0.5 for half the size or 2 for double the size |
Scales the watermark height according to the size of the final image. The heightRatio is used for landscape orientation. Use a square watermark file to ensure better-proportioned results. |