Add watermarks to PDF documents Leave feedback
On this page
GroupDocs.Watermark gives you fine-grained control over watermarks in PDF documents. Open the PDF with PdfLoadOptions and pass a PDF-specific watermark option (such as PdfArtifactWatermarkOptions or PdfAnnotationWatermarkOptions) to add() to target a particular page.
Use PdfArtifactWatermarkOptions and set page_index (0-based) to place a watermark on a specific page. The example below adds a text watermark to the first page and an image watermark to the second.
from groupdocs.watermark import Watermarker
from groupdocs.watermark.watermarks import TextWatermark, ImageWatermark, Font, Color
from groupdocs.watermark.common import HorizontalAlignment, VerticalAlignment
from groupdocs.watermark.options.pdf import PdfLoadOptions, PdfArtifactWatermarkOptions
def add_watermark_to_page():
with Watermarker("./document.pdf", PdfLoadOptions()) as watermarker:
# Text watermark on the first page (page_index is 0-based)
text_watermark = TextWatermark("CONFIDENTIAL", Font("Arial", 19.0))
text_watermark.foreground_color = Color.red
text_watermark.horizontal_alignment = HorizontalAlignment.CENTER
text_watermark.vertical_alignment = VerticalAlignment.CENTER
text_options = PdfArtifactWatermarkOptions()
text_options.page_index = 0
watermarker.add(text_watermark, text_options)
# Image watermark on the second page
with ImageWatermark("./logo.png") as image_watermark:
image_watermark.horizontal_alignment = HorizontalAlignment.RIGHT
image_watermark.vertical_alignment = VerticalAlignment.TOP
image_options = PdfArtifactWatermarkOptions()
image_options.page_index = 1
watermarker.add(image_watermark, image_options)
watermarker.save("./output.pdf")
if __name__ == "__main__":
add_watermark_to_page()
document.pdf (two pages) and logo.png are the sample files used in this example. Download document.pdf and logo.png.
Binary file (PDF, 221 KB)
PdfAnnotationWatermarkOptions works the same way and adds the watermark as a page annotation instead of an artifact; see Watermarks in PDF document.
Operations that read or modify the PDF content tree — watermarking the existing images on a page, reading a page’s size, applying PDF page margins, and working with PDF attachments — are accessed through Watermarker.get_content(), which returns a PdfContent exposing pages, attachments, and more.
from groupdocs.watermark import Watermarker
from groupdocs.watermark.watermarks import TextWatermark, Font, SizingType
from groupdocs.watermark.common import HorizontalAlignment, VerticalAlignment
from groupdocs.watermark.options.pdf import PdfLoadOptions
with Watermarker("./document.pdf", PdfLoadOptions()) as watermarker:
watermark = TextWatermark("Protected image", Font("Arial", 8.0))
watermark.horizontal_alignment = HorizontalAlignment.CENTER
watermark.vertical_alignment = VerticalAlignment.CENTER
watermark.sizing_type = SizingType.SCALE_TO_PARENT_DIMENSIONS
watermark.scale_factor = 1.0
pdf_content = watermarker.get_content()
for image in pdf_content.pages[0].find_images():
image.add(watermark)
watermarker.save("./output.pdf")
For the full set of PDF content operations — XObjects, artifacts, and annotations; attachments; and rasterization — see the dedicated topics:
- Watermarks in PDF document
- Existing objects in PDF document
- Attachments in PDF document
- Rasterize document or page
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
