GroupDocs.Watermark for Python via .NET Overview Leave feedback

GroupDocs.Watermark for Python via .NET is a native Python library that adds, searches, and removes text and image watermarks across PDF, Word, Excel, PowerPoint, Visio, email, and image formats. It runs entirely on-premise, requires no Microsoft Office installation, and ships as a pre-built wheel for Windows, Linux, and macOS.

Typical uses include:

• Document security — stamp every file in a pipeline with a “Confidential” or “Draft” mark that is hard to remove with third-party tools.
• Branding — overlay a logo or seal on documents and on the images embedded inside them.
• Cleanup and migration — find and remove outdated labels or third-party watermarks before sharing or re-publishing.
• Compliance and tamper-resistance — lock watermarks, add print-only PDF annotations, or rasterize pages so the watermark cannot be edited out.
• Auditing — search documents for existing watermarks by text, image similarity, or formatting, and report or modify them.

Add a text watermark to a document and save the result with just a few lines of code:

from groupdocs.watermark import Watermarker
from groupdocs.watermark.watermarks import TextWatermark, Font, Color

def quick_example():
    # Open the document, add a text watermark, and save the result
    with Watermarker("./document.docx") as watermarker:
        watermark = TextWatermark("CONFIDENTIAL", Font("Arial", 36))
        watermark.foreground_color = Color.red
        watermark.opacity = 0.5
        watermarker.add(watermark)
        watermarker.save("./watermarked.docx")

if __name__ == "__main__":
    quick_example()

Binary file (DOCX, 13 KB)

For finer control, scale, rotate, and center the watermark:

from groupdocs.watermark import Watermarker
from groupdocs.watermark.watermarks import TextWatermark, Font, Color, SizingType
from groupdocs.watermark.common import HorizontalAlignment, VerticalAlignment

def watermark_with_options():
    with Watermarker("./document.docx") as watermarker:
        watermark = TextWatermark("CONFIDENTIAL", Font("Arial", 36))
        watermark.foreground_color = Color.red
        watermark.opacity = 0.5
        watermark.rotate_angle = 45.0
        # Scale the watermark relative to the page and center it
        watermark.sizing_type = SizingType.SCALE_TO_PARENT_DIMENSIONS
        watermark.scale_factor = 0.8
        watermark.horizontal_alignment = HorizontalAlignment.CENTER
        watermark.vertical_alignment = VerticalAlignment.CENTER
        watermarker.add(watermark)
        watermarker.save("./watermarked.docx")

if __name__ == "__main__":
    watermark_with_options()

Binary file (DOCX, 13 KB)

1. Install the package — Installation walks through PyPI and offline wheel installation for Windows, Linux, and macOS.
2. Add your first watermark — Quick Start Guide stamps a document in five minutes.
3. Explore the examples — How to Run Examples clones the runnable repository and runs every documented scenario locally or in Docker.
4. Use it in depth — the Developer Guide covers adding, customizing, searching, modifying, and removing watermarks across every supported format.
5. Licensing — Licensing and Subscription explains evaluation mode and how to apply a license.