Home Search

DriveWorks Pro 22
PDF: Add Watermark Image

Send Feedback

PDF: Add Watermark Image

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

One watermark is added per page. The watermark can be 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'.
Image fileThe path to the image file to use as the watermark. Accepted image formats include .JPG, .PNG and .BMP.
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 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.
Image File"D:\DriveWorks\DW-Logo.jpg"Will apply the image DW-Logo.jpg as the watermark on the specified pages.
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 on the page to 45 degrees clockwise.