Documentation – Stamps Management

Python-Net: Add Rubber Stamp

Fri, 20 Mar 2026 00:00:00 +0000

Rubber stamp annotations are commonly used in PDFs to indicate approval, review status, or other notes. Using PdfContentEditor, you can define a rectangle for the stamp, set its text and comments, choose a color, and apply it to multiple pages of a document.

Create a PdfContentEditor instance.
Bind the input PDF document.
Loop through pages 1–4.
Add a rubber stamp annotation with custom text, comments, and color.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_rubber_stamp(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    for i in range(1, 5):
        content_editor.create_rubber_stamp(
            i,
            apd.Rectangle(120, 450, 180, 60),
            "Approved",
            "Approved by reviewer",
            apd.Color.green,
        )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Create Rubber Stamp With Appearance File

Fri, 20 Mar 2026 00:00:00 +0000

Rubber stamp annotations can be customized not only with text but also by using an image file as their appearance. This approach is useful for adding company logos, signature stamps, or any visual indicator to your PDF pages.

Create a PdfContentEditor instance.
Bind the input PDF document.
Define a rectangle for the stamp.
Use a custom image file to define the appearance of the rubber stamp.
Set the text and color of the stamp.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_rubber_stamp_with_appearance_file(infile, image_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create rubber stamp using appearance_file overload (image path)
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(100, 400, 200, 60),
        "Stamp with custom appearance",
        apd.Color.dark_green,
        image_file,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Create Rubber Stamp With Appearance Stream

Fri, 20 Mar 2026 00:00:00 +0000

Rubber stamp annotations can be customized using an external image file. Instead of relying only on text-based stamps, you can define a visual appearance (for example, a company logo or approval badge) and place it on a page.

Create a PdfContentEditor instance.
Bind the input PDF document.
Define a rectangle for the stamp location.
Use an image file as the stamp appearance.
Apply text and color settings.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_rubber_stamp_with_appearance_file(infile, image_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create rubber stamp using appearance_file overload (image path)
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(100, 400, 200, 60),
        "Stamp with custom appearance",
        apd.Color.dark_green,
        image_file,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: Move Stamp By Index

Fri, 20 Mar 2026 00:00:00 +0000

When multiple rubber stamps exist on a page, you can move a specific one using its index. The move_stamp() method allows repositioning annotations according to their sequence, which is useful when you don’t track stamp IDs but know their order.

Create a PdfContentEditor instance.
Bind the input PDF document.
Add two rubber stamp annotations on the same page.
Demonstrate how to move a stamp using its index.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_stamp_by_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )
    content_editor.save(outfile)

    # Move first stamp on page 1 by index
    # content_editor.move_stamp(1, 1, 10, 10)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Delete Stamps Globally

Fri, 20 Mar 2026 00:00:00 +0000

When working with multiple pages, you may need to remove certain stamps throughout the entire document. The ‘delete_stamp_by_id()’ and ‘delete_stamp_by_ids()’ methods allow you to delete stamps globally by their identifiers, eliminating the need to iterate through each page manually.

Create a PdfContentEditor instance.
Bind the input PDF document.
Add rubber stamps to multiple pages.
Delete stamps globally using their IDs.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def delete_stamps_globally(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    # Add stamps across multiple pages so global deletion is meaningful
    for page in range(1, 5):
        content_editor.create_rubber_stamp(
            page,
            apd.Rectangle(120, 500, 180, 60),
            "Draft",
            "Stamp for global deletion",
            apd.Color.gray,
        )

    # delete_stamp_by_id without page number removes stamp ID from all pages
    content_editor.delete_stamp_by_id(1)
    # delete_stamp_by_ids without page number removes a list of IDs from all pages
    content_editor.delete_stamp_by_ids([2, 3])

    # Save updated document
    content_editor.save(outfile)

Python-Net: List Stamps

Fri, 20 Mar 2026 00:00:00 +0000

When working with annotated PDFs, you may need to inspect existing rubber stamps before modifying or removing them. The ‘get_stamps()’ method allows you to retrieve all stamps placed on a particular page. You can then iterate through the results and process them programmatically.

Create a PdfContentEditor instance.
Bind the input PDF document.
Retrieve all stamps from page 1.
Iterate through the stamp collection.
Print each stamp.
Display a message if no stamps exist.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def list_stamps(infile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # List all stamps on page 1
    stamps = content_editor.get_stamps(1)

    count = 0
    for stamp in stamps:
        count += 1
        print(f"Stamp {count}: {stamp}")

    if count == 0:
        print("No stamps found")

Python-Net: Move Stamp By ID

Fri, 20 Mar 2026 00:00:00 +0000

After adding a rubber stamp annotation to a PDF, you may need to adjust its position. The ‘move_stamp_by_id()’ method allows you to relocate a stamp based on its identifier, without recreating it. This is useful in automated workflows where stamp placement must be dynamically adjusted.

Create a PdfContentEditor instance.
Bind the input PDF document.
Add a rubber stamp annotation.
Move the stamp using its ID.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_stamp_by_id_example(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(300, 420, 180, 60),
        "Approved",
        "Move this stamp by ID",
        apd.Color.green,
    )

    # Move stamp by ID overload
    content_editor.move_stamp_by_id(1, 1, 240, 360)

    # Save updated document
    content_editor.save(outfile)

Python-Net: Delete Stamp By ID

Fri, 20 Mar 2026 00:00:00 +0000

When working with PDFs containing multiple stamps, it is often necessary to remove specific stamps without affecting others. Using ID-based deletion, you can precisely control which stamps to remove:

‘delete_stamp_by_id(stamp_id, page_number)’ – deletes a single stamp by its ID on a specific page
‘delete_stamp_by_ids(page_number, stamp_ids)’ – deletes multiple stamps by their IDs on a given page

Create a PdfContentEditor instance.
Bind the input PDF document.
Add two rubber stamps with distinct IDs.
Delete stamps using both single-ID and multiple-ID deletion methods.
Save the updated PDF.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def delete_stamp_by_ids_examples(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    # Create two stamps on page 1 so they can be deleted by ID
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(120, 320, 180, 60),
        "Draft",
        "Delete by single ID",
        apd.Color.orange,
    )
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(120, 250, 180, 60),
        "Draft",
        "Delete by multiple IDs",
        apd.Color.orange,
    )

    # Delete by single ID overload and by IDs overload
    content_editor.delete_stamp_by_id(1, 1)
    content_editor.delete_stamp_by_ids(1, [2])

    # Save updated document
    content_editor.save(outfile)

Python-Net: Move Stamp By Index

Fri, 20 Mar 2026 00:00:00 +0000

In PDF editing, it may be necessary to adjust the position of existing rubber stamps. This code snippet shows how to:

Add multiple stamps on the same page
Prepare them for repositioning using their index
Optionally move a stamp by specifying its page, index, and new coordinates

The ‘move_stamp(page_number, stamp_index, new_x, new_y)’ method can reposition stamps precisely.

Create a PdfContentEditor object.
Bind the PDF to the editor.
Add multiple rubber stamps to a page.
Save the document before performing movement operations.
Move a specific stamp by its index.
Save the updated PDF.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def move_stamp_by_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )
    content_editor.save(outfile)

    # Move first stamp on page 1 by index
    # content_editor.move_stamp(1, 1, 10, 10)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Manage Stamp By ID

Fri, 20 Mar 2026 00:00:00 +0000

In PDFs with multiple rubber stamps, it can be useful to control individual stamps based on their ID. The ‘hide_stamp_by_id()’ and ‘show_stamp_by_id()’ methods allow selective visibility control. This example shows how to:

Add multiple stamps with unique IDs
Hide a stamp on a specific page
Show a stamp on another page

By using ID-based operations, you avoid tracking stamps by page position or other attributes.

Create a PdfContentEditor instance.
Bind the input PDF document.
Add rubber stamps with specific IDs.
Hide and shows stamps based on their IDs and page numbers.
Save the updated PDF document.

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def manage_stamp_by_id(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    # Apply ID-based stamp operations
    content_editor.hide_stamp_by_id(1, 1)
    content_editor.show_stamp_by_id(1, 2)

    # Save updated document
    content_editor.save(outfile)