CloudConvert icon

CloudConvert

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

Actions8

Overview

The node integrates with CloudConvert, a cloud-based file conversion and processing service. Specifically, the "Add Watermark" operation allows users to add watermarks to various file types such as PDFs, images, or videos. This is useful for branding, copyright protection, or marking files as drafts.

Common scenarios include:

  • Adding a company logo or watermark image to marketing materials.
  • Overlaying text watermarks like "Confidential" or "Draft" on documents.
  • Protecting images by embedding semi-transparent watermarks before sharing.

Practical example: A user uploads an image file and applies a semi-transparent text watermark "Sample" at the bottom-right corner to prevent unauthorized use.

Properties

Name Meaning
Authentication Method of authenticating with CloudConvert: OAuth2 (recommended) or API Key.
Binary Input Data Whether the input file should be taken from a binary field in the incoming data.
Input File Content The raw text content of the file to upload if not using binary input.
Input Filename The filename (including extension) of the input file when not using binary input.
Binary Property Name of the binary property containing the file data when using binary input.
Watermark Image Whether to use an image as the watermark instead of text.
Image URL URL of the image (PNG, JPG, SVG) to use as the watermark if Watermark Image is true.
Text Text string to use as the watermark if Watermark Image is false.
Font Size Font size of the text watermark.
Font Color Color of the text watermark font.
Vertical Position Vertical placement of the watermark on the file: Top, Center, or Bottom.
Horizontal Position Horizontal placement of the watermark on the file: Left, Center, or Right.
Vertical Margin Vertical spacing margin around the watermark.
Horizontal Margin Horizontal spacing margin around the watermark.
Opacity Opacity percentage (0-100) controlling watermark transparency; 100 means fully visible.
Additional Options JSON dictionary for extra options to customize the watermarking task, compatible with CloudConvert's job builder format.

Output

The node outputs the processed file with the watermark applied. The output is provided in the json field and typically includes metadata about the converted file and a reference to the resulting file data.

If the input was binary, the output will also contain the binary data of the watermarked file under the specified binary property.

Dependencies

  • Requires a valid CloudConvert account and API access.
  • Supports authentication via OAuth2 or API key credential.
  • Needs internet access to communicate with CloudConvert's API.
  • If using an image watermark, the image must be accessible via a public URL.

Troubleshooting

  • Invalid Operation Error: Occurs if an unsupported operation is selected. Ensure "Add Watermark" is chosen.
  • Authentication Failures: Check that the API key or OAuth2 credentials are correctly configured and have necessary permissions.
  • File Not Found or Invalid Input: Verify that the input binary data or file content is correctly provided and the filename has a proper extension.
  • Image URL Issues: When using an image watermark, ensure the URL is publicly accessible and points to a supported image format (PNG, JPG, SVG).
  • Opacity or Position Parameters Not Working: Confirm values are within allowed ranges and positions are correctly spelled ("top", "center", "bottom", etc.).
  • JSON Parsing Errors in Additional Options: Validate the JSON syntax in the additional options field to avoid malformed requests.

Links and References

Discussion