Keep up to date with Gravity PDF

  • This field is for validation purposes and should be left unchanged.
This is the legacy Gravity PDF v4 documentation which is NOT supported. Go to the latest documentation.

Introduction #introduction

A watermark is a semi-transparent element overlaid on each page of your PDF. Both text and image watermarks are supported, and you have full control over the transparency.

Example of text watermark

Two unique HTML tags are used to output watermarks (one for text watermarks and one for images):

  • <watermarktext content [ alpha ] />
  • <watermarkimage src [ alpha ] [ size ] [ position ] />

Watermarks cannot be used when setting the PDF format to PDF/A-1b or PDF/X-1a.

Text Watermarks #text-watermark

<watermarktext content [ alpha ] />

Text watermarks can be enabled by including the following HTML in your PDF template:

<watermarktext content="PRIVATE" />
content #content
The text you want watermarked on the PDF. This is a required attribute.
If content is set to blank it will disable watermarking in the document from that page onwards.
The content attribute must have special characters encoded correctly. This includes the <, >, ', " and & symbols. To prevent unexpected behaviour use the PHP function htmlspecialchars.
<watermarktext content="<?php echo htmlspecialchars( '<CONFIDENTIAL>', ENT_QUOTES ); ?>" />
alpha #alpha
Controls the text transparency and should be a number between 0-1. This field is optional.
<watermarktext content="PRIVATE" alpha="0.3" />

Image Watermarks #image-watermark

<watermarkimage src [ alpha ] [ size ] [ position ] />

The image watermark only requires the src attribute. The alpha, size and position attributes are all optional.

src #src
The URL or path to the image. We recommend using the path as it has better support across a range of hosting environments.
alpha #alpha-image
Controls the image transparency and should be a number between 0-1
size #size
Controls the image size that your watermark should be displayed at. By default the image will display at its original size (depending on the PDF DPI settings)
D – Display at original image size (default)
P – Resize image to fit the full page
F – Resize to fit the PDF print area, respecting page margins
width,height – Two comma-separated numbers specifying the width and height of the image in millimetres
position #position
Specifies where the image should be positioned on the page
P – Vertically and horizontally centred on the page
F – Vertically and horizontally centred on the print area with respect to page margins
width,height – Specify the x and y position (in millimetres) of where the image should be placed
<!-- Basic Image Watermark -->
<watermarkimage src="<?php echo PDF_PLUGIN_DIR; ?>resources/images/gravityformspdfextended.jpg" />


<!-- Image watermark with 50% transparency -->
<watermarkimage src="<?php echo PDF_PLUGIN_DIR; ?>resources/images/gravityformspdfextended.jpg" alpha="0.5" />


<!-- Image watermark resized to fit the full page -->
<watermarkimage src="<?php echo PDF_PLUGIN_DIR; ?>resources/images/gravityformspdfextended.jpg" size="P" />


<!-- Image watermark with default size positioned 10mm x 10mm from the top left corner -->
<watermarkimage src="<?php echo PDF_PLUGIN_DIR; ?>resources/images/gravityformspdfextended.jpg" position="10,10" />


<!-- Image watermark resized to 50x50mm image -->
<watermarkimage src="<?php echo PDF_PLUGIN_DIR; ?>resources/images/gravityformspdfextended.jpg" size="50,50" />

Example #example

We’ve put together a sample showing off the text and image watermark capabilities in Gravity PDF.

Signup for the latest Gravity PDF news, tips and updates

  • This field is for validation purposes and should be left unchanged.
Gravity PDF 40K Active Installs Celebration! Take 20% off any products with coupon 40KMILESTONE (this week only)Visit Store
+ +
Scroll To Top

Choose your currency:

Converted prices are for reference only - all orders are charged in $ Australian Dollars ($) AUD.
  • AUDAustralian Dollars ($)
  • USDUS Dollars ($)
  • CADCanadian Dollars ($)
  • EUREuros (€)
  • GBPPound Sterling (£)
  • NZDNew Zealand Dollar ($)
  • JPYJapanese Yen (¥)