CloudConvert icon

CloudConvert

Use CloudConvert to convert files, create thumbnails, merge files, add watermarks and more!
Join our community

Actions51

Overview

This node operation adds a watermark to a file, which can be a PDF, image, or video. It supports both text and image watermarks, allowing customization of watermark appearance such as font size, color, opacity, and positioning. This is useful for branding, copyright protection, or marking documents and media files with identifying information.

Use Case Examples

  1. Adding a company logo as a watermark image to a PDF document before sharing it externally.
  2. Applying a semi-transparent text watermark with the company name to images to prevent unauthorized use.

Properties

Name Meaning
Authentication Method of authenticating with the CloudConvert API, either OAuth2 or API Key.
Binary Input Data Whether the input file to upload should be taken from a binary field.
Input File Contents The text content of the file to upload, used if Binary Input Data is false.
Input File Name The input filename including extension, used if Binary Input Data is false.
Binary Property Name of the binary property containing the file data, used if Binary Input Data is true.
Watermark Image Whether the watermark should be an image or text.
Image URL URL to the image to be used as watermark, required if Watermark Image is true.
Text Text to use as watermark, required if Watermark Image is false.
Font Size Font size of the text watermark.
Font Color Font color of the text watermark.
Vertical Position Vertical position of the watermark on the file.
Horizontal Position Horizontal position of the watermark on the file.
Vertical Margin Vertical spacing margin around the watermark.
Horizontal Margin Horizontal spacing margin around the watermark.
Opacity Opacity percentage of the watermark, where 100 is fully visible.
Additional Options JSON dictionary of additional options for the watermarking task.

Output

JSON

  • data - The resulting file data with the watermark applied.
  • filename - The filename of the watermarked file.
  • mimeType - The MIME type of the watermarked file.

Dependencies

  • CloudConvert API

Troubleshooting

  • Ensure the input file is correctly provided either as binary data or text content depending on the 'Binary Input Data' setting.
  • If using an image watermark, verify the image URL is accessible and points to a valid image format (PNG, JPG, SVG).
  • Check that the authentication credentials (OAuth2 or API Key) are valid and have the necessary permissions.
  • Common errors include invalid operation errors if the operation parameter is incorrect, or file upload errors if the input data is missing or malformed.

Links

Discussion