1. GroupDocs Documentation
  2. /
  3. GroupDocs.Watermark Product Family
  4. /
  5. GroupDocs.Watermark for Python via .NET

GroupDocs.Watermark for Python via .NET

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Watermark MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-watermark -- dnx GroupDocs.Watermark.Mcp --yes
Folders, licensing and more →
groupdocs-watermark-python-net-home PyPI package PyPI downloads

Release notes Download from PyPI Online app

GroupDocs.Watermark for Python via .NET is a document-watermarking API: add styled text and image watermarks, tile them across a page, lock them, target specific pages or slides, and search for or remove existing watermarks — all through one unified API. It works with Word processing, spreadsheets, presentations, PDF, Visio, email, and image formats, with no MS Office or OpenOffice installation required.

Quick example

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

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

Features

  • Text and image watermarks: Add styled text or image watermarks with configurable color, opacity, rotation, alignment, and sizing.
  • Multi-format: PDF, Word processing, spreadsheets, presentations, Visio, email, and images, all behind one API.
  • Format-specific placement: PDF annotations/artifacts, presentation slides, Visio pages, spreadsheet backgrounds and header/footers, and locked Word watermarks.
  • Search and modify: Find watermarks by text, image similarity, or formatting; edit their text or remove them.
  • Page targeting and tiling: Apply watermarks to specific pages or the last page only, or tile them across the whole page.

Supported File Formats

GroupDocs.Watermark supports a wide range of file formats. For a complete list, see the full list of supported formats.

  • Word Processing (DOC, DOCX, DOCM, DOT, DOTX, RTF, ODT)
  • Spreadsheets (XLS, XLSX, XLSM, XLSB)
  • Presentations (PPT, PPTX, PPTM, PPS, PPSX)
  • Fixed-Layout (PDF)
  • Diagrams (VSD, VSDX, VSS, VDX)
  • Email (MSG, EML, EMLX)
  • Images (BMP, JPG, JPEG, PNG, GIF, TIFF, WEBP)

Getting Started

To get started, refer to the System Requirements, Supported Document Formats, Installation, and Quick Start Guide sections for setup instructions.

Developer Guide

For practical code examples and explanations of the open–add–save workflow across every supported family, see the Developer Guide section. It covers adding text and image watermarks, customizing and tiling them, format-specific placement, and searching, modifying, and removing existing watermarks.

Technical Support

If you experience any issues or have suggestions, please refer to the Technical Support topic. This topic provides multiple support channels tailored to your needs.