Add watermarks to word processing documents Leave feedback

Microsoft Word documents can be divided into multiple sections. Headers and footers are associated with sections and are commonly used to display text or graphics across pages. You can add watermarks into headers/footers of a particular section or target specific pages.

Adding watermark to a particular section

This sample adds a shape-based text watermark into the header/footer of a specific section.

Steps:

Load the document
Create and initialize watermark object
Set watermark properties
Create WordProcessingWatermarkSectionOptions and set section_index
Add watermark to the section
Save the document

import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Test watermark", gww.Font("Arial", 19.0))

    options = gwo_wp.WordProcessingWatermarkSectionOptions()
    options.section_index = 0

    watermarker.add(watermark, options)
    watermarker.save("document.docx")

Getting page size

This sample reads section page setup metrics to help with absolute positioning and sizing of watermarks.

Get page setup of a section when using absolute positioning/sizing.

import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    print(content.sections[0].page_setup.width)
    print(content.sections[0].page_setup.height)
    print(content.sections[0].page_setup.top_margin)
    print(content.sections[0].page_setup.right_margin)
    print(content.sections[0].page_setup.bottom_margin)
    print(content.sections[0].page_setup.left_margin)

Adding watermark to the images inside a particular section

This sample finds images within the target section and overlays a centered, rotated text watermark on each.

import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    images = content.sections[0].find_images()
    for image in images:
        image.add(watermark)

    watermarker.save("document.docx")

Adding watermark to the image shapes in a word document

This sample loops through shape images outside headers/footers and applies a centered, rotated text watermark.

import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.common as gwc
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    watermark = gww.TextWatermark("Protected image", gww.Font("Arial", 8.0))
    watermark.horizontal_alignment = gwc.HorizontalAlignment.CENTER
    watermark.vertical_alignment = gwc.VerticalAlignment.CENTER
    watermark.rotate_angle = 45
    watermark.sizing_type = gww.SizingType.SCALE_TO_PARENT_DIMENSIONS
    watermark.scale_factor = 1.0

    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for section in content.sections:
        for shape in section.shapes:
            if shape.header_footer is None and shape.image is not None:
                shape.image.add(watermark)

    watermarker.save("document.docx")

Adding watermark to a particular page of word document

This sample targets one or more pages by number and adds a text watermark only to those pages.

import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    text_watermark = gww.TextWatermark("DRAFT", gww.Font("Arial", 42.0))

    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    options = gwo_wp.WordProcessingWatermarkPagesOptions()
    options.page_numbers = [content.page_count]

    watermarker.add(text_watermark, options)
    watermarker.save("document.docx")

Working with headers and footers

Linking headers and footers

This sample links a header or footer in one section to the previous section to reuse content.

import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp
import groupdocs.watermark.common as gwc

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    content.sections[1].headers_footers[gwc.OfficeHeaderFooterType.FOOTER_EVEN].is_linked_to_previous = True
    watermarker.save("document.docx")

Linking all headers and footers

This sample links all headers/footers in subsequent sections to the first section in a single pass.

import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for i in range(1, content.sections.count):
        content.sections[i].headers_footers.link_to_previous(True)
    watermarker.save("document.docx")

Add watermark to headers and footers with linking

This sample adds a watermark to the first section, then links subsequent sections so the watermark appears throughout.

import groupdocs.watermark as gw
import groupdocs.watermark.watermarks as gww
import groupdocs.watermark.options.wordprocessing as gwo_wp
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    with gww.ImageWatermark("large.png") as watermark:
        options = gwo_wp.WordProcessingWatermarkSectionOptions()
        options.section_index = 0
        watermarker.add(watermark, options)

    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    for i in range(1, content.sections.count):
        content.sections[i].headers_footers.link_to_previous(True)

    watermarker.save("document.docx")

Setting different headers or footers

This sample enables different header/footer configurations (first page, odd/even) at the section level.

import groupdocs.watermark as gw
import groupdocs.watermark.contents.wordprocessing as gwc_wp

load_options = gw.WordProcessingLoadOptions()
with gw.Watermarker("document.docx", load_options) as watermarker:
    content = watermarker.get_content(gwc_wp.WordProcessingContent)
    content.sections[0].page_setup.different_first_page_header_footer = True
    content.sections[0].page_setup.odd_and_even_pages_header_footer = True
    watermarker.save("document.docx")

Advanced use cases

We value your opinion. Your feedback will help us improve our documentation.