Why is Width and Height set to 0 by default?

Zero means unset. When Width and Height are both 0 the watermark is sized by the Scale factor instead, where 1 is the image at its natural size. Entering a non-zero point value in either field overrides Scale, and supplying only one of the two keeps the aspect ratio by calculating the other.

Add Image Watermark To Word Document in n8n

Add Image Watermark To Word is a PDF4me node action in n8n that stamps an image onto a Word document. Use it to brand outgoing reports with a company logo, mark drafts before review, or apply a confidentiality badge to every contract a workflow produces, without opening a single file in Word.

What this node does

PDF4me Word: Add Image Watermark To Word takes two inputs, not one: the .docx file to stamp and the image to stamp onto it. Each has its own input-method dropdown, so the document and the watermark can arrive by different routes, such as a document from a previous node and a logo fetched from a URL. Sizing is by Scale unless you set an explicit Width or Height in points.

Authenticating Your API Request

Every PDF4me node in n8n requires a valid credential. Create or select one that holds your PDF4me API key so the workflow can authenticate watermark requests securely.

Get your API Key

Important Facts You Should Not Miss

Two inputs, two dropdowns

The Word file and the watermark image are configured separately, each with its own input-method selector. Setting one and forgetting the other is the most common reason the node refuses to run.

Width and Height of 0 means use Scale

Both dimension fields ship as 0, which is not a zero-size watermark but an instruction to size the image by the Scale factor. Enter points in either field only when you need an exact size.

Use a transparent PNG

A JPEG has no alpha channel, so its white background covers the text underneath. A PNG with real transparency is what makes a watermark read as a watermark rather than a pasted box.

The PDF4me Word node in n8n with Operation set to Add Image Watermark To Word, Word File Input Method set to Download from URL, Watermark Image Input Method set to From Previous Node, Scale 1, Width and Height 0, and Center Alignment toggled on — Note the two independent input methods: the Word file arrives by URL while the watermark image comes from the previous node. Width and Height sit at 0, so Scale 1 controls the size.

Image Watermark vs Text Watermark in Word

Question	Add Image Watermark To Word	Add Text Watermark To Word
What gets stamped	An image file such as a logo, seal, or badge	A word or phrase you type, such as DRAFT
Second input needed	Yes, the image file itself	No, only the text string
Changing it per run	Swap the image binary or URL	Change the text with an expression
Best for	Company branding and scanned marks	Status labels and per-document text
Transparency control	Semi-Transparent toggle plus PNG alpha	Handled through the text styling options

What Parameters Does Add Image Watermark To Word Need?

The Word file and the watermark image each have an input-method dropdown. Whichever method you pick, the matching source field appears directly beneath it, so the conditional rows below change depending on your selection.

Parameter	Required	What it does	Example
Credential to connect with	Required	The PDF4me API credential the node authenticates with.	`PDF4me account`
Operation	Required	The action this node performs. Select Add Image Watermark To Word.	`Add Image Watermark To Word`
Word File Input Method	Required	How the .docx reaches the node: from the previous node as binary data, as a Base64 string, or downloaded from a URL.	`Download from URL`
Word File URL	Conditional	Public URL of the .docx to stamp. Appears only when the Word file input method is set to download from a URL.	`https://example.com/file.docx`
Document Name	Required	Filename of the input document including the extension. Used for format detection, so keep the .docx suffix accurate.	`document.docx`
Watermark Image Input Method	Required	How the image reaches the node. Independent of the Word file input method, so the two can differ.	`From Previous Node (Binary Data)`
Image Binary Data Property Name	Conditional	Name of the binary property holding the watermark image. Appears when the image comes from the previous node.	`data`
Scale	Optional	Size multiplier applied to the image at its natural size. Ignored when a non-zero Width or Height is supplied.	`1`
Width (Points)	Optional	Exact watermark width in points. Leave at 0 to size by Scale. Setting only Width keeps the aspect ratio.	`0`
Height (Points)	Optional	Exact watermark height in points. Leave at 0 to size by Scale. Setting only Height keeps the aspect ratio.	`0`
Center Alignment	Optional	Toggle that centres the watermark on the page. Ships enabled; turn it off to align to the top left within the margins.	`enabled`
Semi-Transparent	Optional	Toggle that reduces watermark opacity so page text stays readable underneath. Ships disabled.	`disabled`
Culture Name	Optional	Culture code recorded for document processing, such as en-US or de-DE.	`en-US`
Output File Name	Optional	Filename of the returned document. Keep the .docx extension so downstream steps handle it correctly.	`word_with_watermark.docx`
Output Binary Data Name	Optional	Binary property the stamped document is written to. Leave as data unless a later node expects another name.	`data`

Output

Field	Type	What it contains
fileName	`String`	Name of the returned watermarked document, taken from Output File Name.
fileSize	`Number`	Size of the returned document in bytes. A useful sanity check that the image was embedded.
success	`Boolean`	Whether the watermark was applied. Branch on this so failures surface as alerts.
originalFileName	`String`	Name of the input document as supplied in Document Name.
scale	`Number`	The scale factor actually applied, echoed back for verification.
alignImage	`Boolean`	Whether centre alignment was used, reflecting the Center Alignment toggle.
semiTransparent	`Boolean`	Whether reduced opacity was applied, reflecting the Semi-Transparent toggle.
cultureName	`String`	The culture code recorded for the operation.
message	`String`	Human-readable status text describing the result of the operation.

The stamped document itself is returned as binary on the property named in Output Binary Data Name, ready to write to storage, attach to an email, or feed into a PDF conversion step.

How Do I Set Up Add Image Watermark To Word in n8n?

Add the PDF4me Word node to your workflow and set Operation to Add Image Watermark To Word.
Select your PDF4me credential, or create one and paste your API key.
Pick a Word File Input Method and supply the .docx through the field that appears beneath it.
Set Document Name so the .docx extension is present and correct.
Pick a Watermark Image Input Method, then point Image Binary Data Property Name at the property holding the image, usually data.
Leave Width (Points) and Height (Points) at 0 and adjust Scale, or set explicit point values when the size must be exact.
Turn on Semi-Transparent if the watermark sits over body text, and leave Center Alignment on unless you want a top-left mark.
Set Output File Name ending in .docx, execute the node, and route the result onward.

Typical Setups

Workflow ExamplesCommon n8n workflow patterns using Add Image Watermark To Word.

Brand every outgoing report

A reporting step produces a Word document on a schedule.
Add Image Watermark To Word stamps the company logo onto it.
The branded file is emailed to the distribution list.

Mark documents as draft until approved

A contract lands in a review folder.
A DRAFT badge image is stamped with Semi-Transparent enabled.
Reviewers can never mistake the working copy for the final one.

Watermark then convert to PDF

The logo is applied while the file is still editable Word.
A conversion step turns the stamped document into a PDF.
The PDF is published, with the mark baked in rather than overlaid later.

Batch stamp an archive

A folder listing produces one item per legacy .docx.
The node runs once per item with the same watermark image.
The stamped copies are written back under new filenames.

Practical Tips

Start with a transparent PNG

Alpha transparency is what separates a watermark from a pasted rectangle. Export the logo with a transparent background before wiring it in.

Tune Scale before touching Width

Scale keeps the aspect ratio automatically. Reach for explicit point values only when a brand guideline demands an exact size.

Enable Semi-Transparent over body text

A full-opacity mark in the centre of a text page hides content. The toggle exists precisely for documents that are meant to stay readable.

Check the two input methods separately

The document and the image are configured independently, so a run can fail because the image source is unset while the Word source looks fine.

Verify one file before a batch

Open a single stamped document in Word and confirm placement and opacity, then run the workflow across the rest.

Keep the .docx extension

Both Document Name and Output File Name drive format handling. A missing or wrong extension causes confusing downstream failures.

Cheat Sheet

Field	Value
Operation	`Add Image Watermark To Word`
Word File Input Method	`Download from URL`
Word File URL	`https://example.com/file.docx`
Document Name	`document.docx`
Watermark Image Input Method	`From Previous Node (Binary Data)`
Image Binary Data Property Name	`data`
Scale	`1`
Width (Points) / Height (Points)	`0 / 0`
Center Alignment	`enabled`
Semi-Transparent	`disabled`
Culture Name	`en-US`
Output File Name	`word_with_watermark.docx`
Output Binary Data Name	`data`

Common Questions

What image formats can I use as a Word watermark?+

Standard raster image formats work, and a PNG with a transparent background gives the cleanest result because page text stays visible around the logo. A JPEG has no alpha channel, so it stamps an opaque rectangle unless you also enable Semi-Transparent. The PNG specification covers the alpha channel behaviour that makes this work.

Why are Width and Height set to 0 by default?+

Zero means unset, not a zero-size watermark. When both are 0 the image is sized by the Scale factor, where 1 is its natural size. Entering a non-zero point value in either field overrides Scale, and supplying only one of the two preserves the aspect ratio by calculating the other.

Does the watermark appear on every page of the document?+

The action applies the watermark to the document rather than to a single page you nominate, so it suits stamping a whole file such as a contract or report. Run one representative multi-page document through the node and open the result in Word before rolling it out across a batch.

What is the difference between the image and text watermark actions?+

Add Image Watermark To Word stamps a picture such as a company logo or scanned seal and needs an image as a second input. Add Text Watermark To Word Document renders a word or phrase you type, so it needs no image file and is easier to vary per run with an expression.

Can I watermark many Word files in one n8n run?+

Yes. The node processes one document per item, so feed it a list of files from a trigger, a folder listing, or an n8n looping node and the action executes once per item. The same watermark image can be reused across the whole run.

Add Text Watermark To Word Document

The text equivalent, for DRAFT and CONFIDENTIAL labels that need no image file.

Secure Word Document

Add password protection after branding, before the file is distributed.

Add Image Watermark to Image

The same idea applied to photos and graphics rather than Word files.

Update Headers Footers in Word Document

Another way to brand a document, this time in the header and footer regions.