Skip to main content
PDF4me APIIntegrationsKnowledge BaseExtensionsAPI TesterBlog

Add Text Watermark To Image using n8n action

PDF4me Add Text Watermark To Image adds custom text watermarks to images through n8n automation workflows. Process images via n8n triggers, binary data, base64 strings, or public URLs to overlay text (copyright notices, company names, custom text) with customizable positioning (corners, center, diagonal, custom coordinates), font selection, size control, color options, transparency settings, rotation angles, and offset adjustments. This solution is ideal for image branding, copyright protection, watermarking, batch image processing, social media preparation, and automated text overlay workflows that require professional text watermarks with flexible formatting and seamless integration.

Setup​

Add the PDF4me "Add Text Watermark To Image" node to your n8n workflow and configure the required parameters. For initial setup instructions, see our n8n Integration Guide.

Prerequisites:

  • PDF4me API credentials
  • n8n workflow access
Get Your API Key

Configuration:

  1. Add PDF4me node to workflow
  2. Select "Add Text Watermark To Image" action
  3. Configure input parameters (see below)
Add Text Watermark To Image

Parameters​

Complete list of parameters for the Add Text Watermark to Image action. Configure these parameters to control text watermark application.

Important: Parameters marked with an asterisk (***) are required and must be provided for the action to function correctly.

ParameterTypeDescriptionExample
ActionStringYesPDF4me action selection - Specify the type of operation to perform. For text watermarking, select "Add Text Watermark To Image" from the available actions
Input Image Data TypeStringYesPDF4me image input format selection
Choose the format of your source image data input.
PDF4me supports multiple input types with different field requirements
1) Binary DataYes (One Required)1) Binary Data - Use "Input Binary Field" to reference image file from previous node
2) Base64 StringYes (One Required)2) Base64 String - Use "Base64 Image Content" field for encoded image data
3) URLYes (One Required)3) URL - Use "Image URL" field to provide a public/open permission URL to the image file to watermark
Input Binary FieldBinaryYes (If Binary Data)PDF4me binary image file input - Reference source image file (.jpg, .png, .gif, .bmp) from previous n8n node or file upload. PDF4me processes binary image files with automatic format detection and validation. Required when Input Image Data Type is "Binary Data"
Base64 Image ContentStringYes (If Base64 String)PDF4me base64 encoded image input - Provide source image data (.jpg, .png, .gif, .bmp) as base64 encoded string for secure transmission. PDF4me automatically decodes and processes the image content. Required when Input Image Data Type is "Base64 String"
Image URLStringYes (If URL)PDF4me public image URL input - Provide a public/open permission URL to the source image file (.jpg, .png, .gif, .bmp) to be watermarked. PDF4me downloads and processes the file from the provided URL. Required when Input Image Data Type is "URL"
Watermark TextStringYesPDF4me text watermark content - Enter the text content to be used as a watermark on the image. This can include company names, copyright notices, dates, or any custom text for branding and protection purposes
Text PositionStringYesPDF4me text positioning - Choose the position where the text watermark will be placed on the source image. PDF4me provides predefined positions for consistent text placement across different image sizes and aspect ratios
Top RightYes (One Required)Top Right Position - Places text watermark in the top-right corner of the image with precise corner alignment
Top LeftYes (One Required)Top Left Position - Places text watermark in the top-left corner of the image with precise corner alignment
Bottom RightYes (One Required)Bottom Right Position - Places text watermark in the bottom-right corner of the image with precise corner alignment
Bottom LeftYes (One Required)Bottom Left Position - Places text watermark in the bottom-left corner of the image with precise corner alignment
Central HorizontalYes (One Required)Central Horizontal Position - Places text watermark in the horizontal center of the image with precise center alignment
Central VerticalYes (One Required)Central Vertical Position - Places text watermark in the vertical center of the image with precise center alignment
DiagonalYes (One Required)Diagonal Position - Places text watermark diagonally across the image for watermark protection and branding
CustomYes (One Required)Custom Position - Allows custom positioning using Position X and Position Y coordinates for pixel-perfect placement
Font FamilyStringYesPDF4me font selection - Specify the font family for the text watermark. Choose from standard fonts like Arial, Times New Roman, Helvetica, or any system-available font for professional typography
Font SizeNumberYesPDF4me font size control - Set the size of the text watermark in points. Larger values create more prominent watermarks, while smaller values create subtle text overlays. Recommended range is 12-72 points for optimal visibility
Text ColorStringYesPDF4me text color specification - Define the color of the text watermark using hexadecimal color codes (e.g., #FF0000 for red, #000000 for black). PDF4me supports full color spectrum for custom branding and visual impact
Horizontal OffsetNumberNoPDF4me horizontal offset positioning - Set horizontal offset in pixels to fine-tune text watermark placement from the selected position. Positive values move the text right, negative values move it left. Default is 0 for precise positioning
Vertical OffsetNumberNoPDF4me vertical offset positioning - Set vertical offset in pixels to fine-tune text watermark placement from the selected position. Positive values move the text down, negative values move it up. Default is 0 for precise positioning
Position XNumberNoPDF4me absolute X coordinate - Set absolute horizontal position in pixels from the left edge of the image. This overrides the Text Position setting when specified. Use for pixel-perfect text watermark placement
Position YNumberNoPDF4me absolute Y coordinate - Set absolute vertical position in pixels from the top edge of the image. This overrides the Text Position setting when specified. Use for pixel-perfect text watermark placement
RotationNumberNoPDF4me text rotation angle - Set rotation angle in degrees (0-360) to rotate the text watermark. Positive values rotate clockwise, negative values rotate counterclockwise. Default is 0 for no rotation
OpacityNumberNoPDF4me text transparency control - Set opacity level from 0.0 to 1.0 where 0.0 is entirely transparent and 1.0 is full opacity. PDF4me provides advanced transparency control for creating subtle text effects and layered image elements
Output File NameStringYesPDF4me watermarked image output filename - Specify the name for the generated watermarked image file with proper extension (.jpg, .png). PDF4me ensures unique naming and validates file format compliance
Binary Data Output NameStringYesPDF4me binary data mapping - Define the variable name for accessing the generated watermarked image binary data in your n8n workflow. This binary data can be used as input data in subsequent actions within your workflow

Supported Image Formats​

FormatDescriptionFile ExtensionsMax SizeUse Cases
JPEGJoint Photographic Experts Group with optimized compression for photographic content.jpg, .jpeg50MBPhotographic text watermarks, detailed images, high-quality image branding
PNGPortable Network Graphics with advanced transparency support and lossless compression.png50MBText watermarks with transparency, logos, stamps with transparency, professional branding
GIFGraphics Interchange Format with animation support and limited color palette.gif50MBAnimated text watermarks, simple graphics, web-optimized branding
BMPBitmap image format with uncompressed pixel data and high quality.bmp50MBHigh-quality text watermarks, detailed graphics, professional image processing

Supported Font Families​

Font FamilyDescriptionBest Use Cases
ArialClean, modern sans-serif font with excellent readabilityProfessional documents, corporate branding, web content
Times New RomanClassic serif font with traditional appearanceFormal documents, academic papers, legal content
HelveticaSwiss-designed sans-serif with neutral characterCorporate branding, technical documentation, clean layouts
CalibriModern sans-serif designed for screen readingDigital content, presentations, user interfaces
VerdanaWide, readable font optimized for screen displayWeb content, digital signage, accessibility-focused designs

Output​

Output Parameters​

ParameterTypeDescriptionExample
fileNameStringPDF4me generated image filename - The complete filename of the successfully generated watermarked image with proper extension. PDF4me ensures unique naming and validates file format compliance for seamless integration with downstream processesimage_with_text_watermark.jpg
fileSizeNumberPDF4me image file size in bytes - The exact size of the generated watermarked image file in bytes, provided by PDF4me for storage planning, bandwidth optimization, and file transfer monitoring. Essential for enterprise image management and workflow automation245760
successBooleanPDF4me text watermark status indicator - Boolean flag indicating the success or failure of the text watermark addition process. PDF4me returns true for successful operations and false for any errors, enabling robust error handling in automated workflowstrue
mimeTypeStringPDF4me output MIME type - MIME type of the generated image file (e.g., "image/jpeg", "image/png"). Useful for content type validation and proper file handling in web applicationsimage/jpeg
messageStringPDF4me text watermark status message - Human-readable status message providing details about the text watermark addition process result. Includes success confirmation or error details for troubleshootingText watermark added successfully

N8N Action Response​

The PDF4me Add Text Watermark To Image API returns a response that can be viewed in multiple formats. Choose the view that best fits your needs:

JSON Response Format

The raw JSON response from the API:

[
  {
    "success": true,
    "message": "Text watermark added successfully",
    "fileName": "image_with_text_watermark.jpg",
    "mimeType": "image/jpeg",
    "fileSize": 245760
  }
]

Use Cases​

Professional Image Branding​

  • Add company names and copyright notices to product images for brand protection
  • Create branded social media content with consistent text watermark placement
  • Implement copyright protection for digital photography and artwork with custom text

Automated Content Processing​

  • Batch text watermark processing for large image collections
  • Integrate text watermarking into content management workflows
  • Automate image preparation for e-commerce and marketing materials with dynamic text

Enterprise Image Management​

  • Standardize text branding across multiple departments
  • Implement automated text watermarking for document and image workflows
  • Create consistent visual identity with custom text overlays across all digital assets

Dynamic Text Watermarking​

  • Generate time-stamped watermarks for document versioning
  • Add location-based text watermarks for geographic content
  • Create personalized text watermarks with user-specific information

Get Help​

n8n Integration Guiden8n SampleGetting Started