Documentation – PdfFileStamp Class

Python-Net: Add Footer to PDF

Mon, 13 Apr 2026 00:00:00 +0000

Aspose.PDF for Python via .NET provides the PdfFileStamp facade for adding repeated content to PDF pages. You can use it to place footer text or images at the bottom of each page and adjust the footer margins to control placement.

Add a text footer

Use add_footer() with a FormattedText object when you want to place the same text footer on every page of the PDF. The second argument sets the bottom margin used for footer placement.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_text_footer(infile: str, outfile: str) -> None:
    """Add a text footer with a bottom margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("Sample Footer")
        pdf_stamper.add_footer(text, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Use add_footer() with an image stream when the footer should display a logo or another image instead of text. The example opens the image file as a binary stream and places it at the bottom of each page.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_image_footer(infile: str, image_file: str, outfile: str) -> None:
    """Add an image footer with a bottom margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_footer(image_file, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Use the overload with three margin values when you need more control over footer placement. In this example, the footer is added with custom bottom, left, and right margins.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_footer_with_margins(infile: str, outfile: str) -> None:
    """Add a text footer with bottom, left, and right margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("This footer has margins on all sides.")
        pdf_stamper.add_footer(text, 20, 20, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: Add Header to PDF

Mon, 13 Apr 2026 00:00:00 +0000

Aspose.PDF for Python via .NET provides the PdfFileStamp facade for adding repeated content to PDF pages. You can use it to place header text or images at the top of each page and adjust the header margins to control placement.

Add a text header

Use add_header() with a FormattedText object when you want to place the same header text on every page of the PDF. The second argument defines the top margin for the header.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_text_header(infile: str, outfile: str) -> None:
    """Add a text header with a top margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("Sample Header")
        pdf_stamper.add_header(text, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Add an image header

Use add_header() with an image file or image stream when the header should display a logo or another graphic. This is useful for branded document layouts.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_image_header(infile: str, image_file: str, outfile: str) -> None:
    """Add an image header with a top margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_header(image_file, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Add a header with custom margins

Use the overload with three margin values when you need more control over header placement. In this example, the header is added with custom top, left, and right margins.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_header_with_margins(infile: str, outfile: str) -> None:
    """Add a text header with top, left, and right margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText(
            text="Sample Header",
            text_color=ap_pydrawing.Color.blue,
            font_name="Arial",
            text_encoding=pdf_facades.EncodingType.WINANSI,
            embedded=True,
            font_size=12.0,
        )
        pdf_stamper.add_header(text, 20, 20, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: Add Page Number to PDF

Mon, 13 Apr 2026 00:00:00 +0000

Aspose.PDF for Python via .NET provides the PdfFileStamp facade for adding repeated content to PDF pages. You can use it to insert page numbers with default placement, position them at specific coordinates, or control their alignment and margins.

Add page numbers with the default placement

Use add_page_number() without extra position arguments when you want page numbers to be added in the default location. This is the simplest way to number every page in the document.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_default(infile: str, outfile: str) -> None:
    """Add centered page numbers to the bottom of each page."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number("Page #")
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Add page numbers at custom coordinates

Use the coordinate-based overload when you need page numbers to appear at a specific X and Y position on each page. This approach is useful when the document layout requires a custom placement.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_at_coordinates(infile: str, outfile: str) -> None:
    """Add page numbers at explicit X/Y coordinates."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number("Page #", 300, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Add page numbers with alignment and margins

Use the overload with position and margin arguments when you need more control over where page numbers appear. In this example, the numbers are aligned to the upper-right area of the page with explicit margins.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_with_position_and_margins(infile: str, outfile: str) -> None:
    """Add page numbers using a predefined position and page margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number(
            "Page #",
            pdf_facades.PdfFileStamp.POS_BOTTOM_RIGHT,
            10,
            10,
            10,
            10,
        )
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Add page numbers with Roman style

The ‘add_page_numbers_with_roman_style’ function shows how to enhance a PDF document by adding page numbers using uppercase Roman numerals. It leverages the PdfFileStamp class from Aspose.PDF to apply consistent numbering across all pages.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_page_numbers_with_roman_style(infile: str, outfile: str) -> None:
    """Add page numbers with a custom start value and Roman numbering."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.numbering_style = ap.NumberingStyle.NUMERALS_ROMAN_UPPERCASE
        pdf_stamper.starting_number = 42
        pdf_stamper.add_page_number("Page #", pdf_facades.PdfFileStamp.POS_UPPER_RIGHT)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: Add Stamp to PDF

Mon, 13 Apr 2026 00:00:00 +0000

Aspose.PDF for Python via .NET provides the PdfFileStamp facade for adding repeated content to PDF pages. In addition to headers, footers, and page numbers, you can use it to place text-based stamps on each page of a document.

Add the stamp to a PDF

After the stamp is configured, bind the input PDF to PdfFileStamp, add the stamp, and save the output file. This applies the configured stamp across the document.

import sys
from os import path

import aspose.pdf.facades as pdf_facades

CURRENT_DIR = path.dirname(__file__)
EXAMPLES_DIR = path.abspath(path.join(CURRENT_DIR, "..", ".."))
if EXAMPLES_DIR not in sys.path:
    sys.path.insert(0, EXAMPLES_DIR)

from config import initialize_data_dir, set_license


def add_stamp_to_pdf(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp to a PDF file."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Documentation – PdfFileStamp Class

Python-Net: Add Footer to PDF

Add a text footer

Add an image footer

Add a footer with custom margins

Python-Net: Add Header to PDF

Add a text header

Add an image header

Add a header with custom margins

Python-Net: Add Page Number to PDF

Add page numbers with the default placement

Add page numbers at custom coordinates

Add page numbers with alignment and margins

Add page numbers with Roman style

Python-Net: Add Stamp to PDF

Add the stamp to a PDF