CloudConvert icon

CloudConvert

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

Actions8

Overview

The CloudConvert node's "Add Watermark" operation allows you to add a watermark—either text or an image—to PDF files, images, or videos using the CloudConvert API. This is useful for branding, copyright protection, or marking documents as confidential. Typical use cases include automatically watermarking invoices before sending them to clients, adding logos to marketing images, or stamping videos with ownership information.

Practical examples:

  • Automatically watermark all uploaded PDFs with your company logo.
  • Add a "DRAFT" text watermark to images generated in a workflow.
  • Stamp videos with a semi-transparent copyright notice before publishing.

Properties

Name Meaning
Authentication Select authentication method:
- OAuth2 (Recommended)
- API Key
Binary Input Data Whether the input file should be taken from a binary field (true) or provided as text content (false).
Input File Content The text content of the file to upload (used if Binary Input Data is false).
Input Filename The filename (including extension) for the input file (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 (true) or text (false).
Image URL The URL to the image (PNG, JPG, SVG) to use as the watermark (required if Watermark Image is true).
Text The text to use as the watermark (required if Watermark Image is false).
Font Size Font size for the text watermark (required if Watermark Image is false).
Font Color Font color for the text watermark (required if Watermark Image is false).
Vertical Position Vertical position of the watermark:
- Top
- Center
- Bottom
Horizontal Position Horizontal position of the watermark:
- Left
- Center
- Right
Vertical Margin Spacing above and below the watermark.
Horizontal Margin Spacing to the left and right of the watermark.
Opacity Opacity percentage (0–100) for the watermark; 100 means fully visible.
Additional Options JSON dictionary of extra options to customize the watermarking task.

Output

  • The node outputs the processed file with the watermark applied.
  • If the input was binary, the output will also be binary, typically under a property such as data.
  • The output JSON may contain metadata about the conversion process, such as status, file name, and download URL.
  • Example output structure:
{
  "data": {
    "fileName": "watermarked_document.pdf",
    "mimeType": "application/pdf"
  },
  "cloudConvert": {
    "jobId": "12345678",
    "status": "finished",
    "downloadUrl": "https://.../output.pdf"
  }
}

Dependencies

  • External Service: Requires a CloudConvert account and access to the CloudConvert API.
  • Authentication: You must provide either an API Key or set up OAuth2 credentials in n8n.
  • n8n Configuration: Credentials for CloudConvert must be configured in n8n under the appropriate authentication method.

Troubleshooting

  • Common Issues:

    • Invalid Credentials: If authentication fails, ensure your API Key or OAuth2 setup is correct.
    • Missing Required Fields: If required fields (e.g., Image URL or Text) are not provided based on your selection, the node will throw an error.
    • Unsupported File Types: Attempting to watermark unsupported file types may result in errors from CloudConvert.
    • File Not Found: If the specified binary property does not exist, the node will fail.

  • Error Messages:

    • "Invalid operation watermark": This indicates a misconfiguration in the operation parameter.
    • "Missing required parameter...": Ensure all required properties are filled out according to your watermark type (text or image).
    • "401 Unauthorized" or similar: Check your API credentials.

Links and References

Discussion