Documentation – Text Operations

Python-Net: Replace Text On Page

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

Text replacement is a common requirement when updating PDF documents. Using PdfContentEditor, you can search for specific text and replace it with new content. The ‘replace_text_strategy’ property allows you to control how many occurrences are replaced.

Create a PdfContentEditor instance.
Bind the input PDF document.
Configure text replacement strategy.
Replace the target text.
Save the updated PDF document.

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

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

from config import set_license, initialize_data_dir


def replace_text_on_page(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Replace text on page 1
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_FIRST
    )
    content_editor.replace_text("PDF", "Page 1 Replaced Text", 14)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Replace Text On Page With State

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

Sometimes replacing text in a PDF also requires formatting changes such as color or font size. Using TextState, you can define styling properties and apply them during replacement. This allows you to highlight modified text or enforce consistent formatting across documents.

Create a PdfContentEditor instance.
Bind the input PDF document.
Define a TextState with custom formatting.
Configure the replacement strategy.
Replace text on a specific page.
Save the updated PDF document.

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

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

from config import set_license, initialize_data_dir


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

    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.red
    text_state.font_size = 12

    # Replace text on a specific page with explicit text formatting
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text("software", 1, "SOFTWARE PAGE 1", text_state)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Replace Text Regex

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

Regular expressions allow flexible text replacement based on patterns instead of fixed strings. By enabling regex support in ‘replace_text_strategy’, you can match dynamic content such as numbers, dates, or formatted strings.

Create a PdfContentEditor instance.
Bind the input PDF document.
Configure replacement strategy to use regex.
Replace matching patterns across the entire document.
Save the updated PDF document.

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

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

from config import set_license, initialize_data_dir


def replace_text_regex(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Replace text in the whole document
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text_strategy.is_regular_expression_used = True
    content_editor.replace_text(r"\d{4}", "[NUMBER]")
    # Save updated document
    content_editor.save(outfile)

Python-Net: Replace Text Simple

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

Simple text replacement is useful when updating repeated values in a document. With PdfContentEditor, you can define a replacement scope and substitute text globally across all pages.

Create a PdfContentEditor instance.
Bind the input PDF document.
Configure replacement scope for all occurrences.
Replace the target text.
Save the updated PDF document.

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

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

from config import set_license, initialize_data_dir


def replace_text_simple(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Replace text in the whole document
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text("33", "XXXIII ")
    # Save updated document
    content_editor.save(outfile)

Python-Net: Replace Text With State

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

When updating text in a PDF, you may want the replacement content to stand out. By using a TextState object, you can define styling such as color and font size, then apply it to all replaced text.

Create a PdfContentEditor instance.
Bind the input PDF document.
Define a TextState with custom formatting.
Configure replacement scope.
Replace text across the entire document.
Save the updated PDF document.

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

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

from config import set_license, initialize_data_dir


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

    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.blue
    text_state.font_size = 14

    # Replace text with explicit text formatting
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text("software", "SOFTWARE", text_state)
    # Save updated document
    content_editor.save(outfile)