Home Search

DriveWorks Pro 22
PDF: Add Watermark Text

Send Feedback

PDF: Add Watermark Text

This Specification Task will create a text watermark on the specified pages of a target PDF file.

One watermark is added per page. The watermark text can be restyled, repositioned, and rotated.


Property NameDescription
TitleChanges the Title (not the name) of the task.
PDF FileThe path to the PDF file to modify.
Page RangeUse '*' or leave empty to select all pages. Also accepts a pipebar delimited list of page numbers, e.g. '1|2|3', or a range using a hyphen, e.g. '1-3'.
Watermark TextSpecifies the text value to be inserted as a watermark.

This text is inserted as a single line.

Watermark FontSpecifies the font to be used for the watermark.

Text decoration cannot be used when specifying a font, for example: underline.

Watermark ColorSpecifies the color the be used for the watermark. Color names, Hex codes and RGB codes are accepted formats.

RGB codes are specified with pipe separators.

If empty, black will be used as the default color.

PositionSpecifies the relative position of the watermark on the page in the format Vertical|Horizontal. The Vertical value can be one of Top, Center, or Bottom. The Horizontal value can be one of Left, Center, or Right.

If empty, this will default to Center|Center.

MarginsA pipebar delimited list of margins in which the watermark must sit on the page. This property can be used to precisely adjust the position of a given watermark. Margin values are specified in the following order - Top|Right|Bottom|Left.
OpacitySpecifies the opacity of the watermark text as a value between 0.0 (transparent) and 1.0 (opaque).
Rotation AngleThe rotation angle of the watermark in degrees.

Specify positive values to achieve the desired clockwise rotation.


When this Task is added the properties are static. To be able to build rules on a static property see How To: Change A Static Property To A Dynamic Property.

Property NameExample RuleMeaning
PDF File"D:\DriveWorks\MyPDF.pdf"Will add the watermark to MyPDF.pdf.
Page Range"2-4|7|9"Will apply the watermark to pages 2,3,4,7 and 9.
Watermark Text"DRAFT"Will us the text "DRAFT" as the watermark on the specified pages.
Watermark Font"font-family: arial; font-size: 20pt;"Will use the font arial, 20pt.
Watermark Color"#233f6b"Will apply the Hex code #233f6b to the watermark text.
Position"Center|Left"Will place the watermark in the center of the page, alighted to the left-hand side.
Margins"0|0|0|50"Will adjust the left-hand margin of the available page for the watermark. This will shift the watermark to the right.
Opacity0.5Will make the watermark translucent.
Rotation Angle45Will rotate the watermark text on the page to 45 degrees clockwise.