pdf-text-replace

instavm's avatarfrom instavm

Replace text in fillable PDF forms by updating form field values. This skill should be used when users need to update names, addresses, dates, or other text in PDF form fields.

⭐648stars🔀26forks📁View on GitHub🕐Updated Dec 10, 2025
[Document Processing]

When & Why to Use This Skill

The PDF Text Replace skill enables automated text modification within fillable PDF form fields. It allows users to programmatically search and replace specific values—such as names, addresses, dates, or reference numbers—while preserving the document's interactive form structure and preventing it from being flattened.

Use Cases

  • 1. Automated Tax Document Updates: Quickly modify names, tax IDs, or financial figures in standard tax forms like Form 5472 or W-9 to ensure accuracy before submission.
  • 2. Corporate Contract Management: Update effective dates, reference numbers, or party names across multiple fillable legal and business contract templates.
  • 3. Bulk Contact Information Modification: Efficiently update office addresses, phone numbers, or email details across a series of pre-filled operational forms.
  • 4. Dynamic Form Personalization: Tailor fillable PDF templates for specific clients or recipients by replacing placeholder text with personalized data in a batch process.
namepdf-text-replace
descriptionReplace text in fillable PDF forms by updating form field values. This skill should be used when users need to update names, addresses, dates, or other text in PDF form fields.

PDF Text Replace Skill

Replace text in fillable PDF forms by updating form field values.

Description

This skill allows you to search and replace text in PDF files that have fillable form fields. It scans all form fields in the PDF, finds fields containing the search text, and replaces it with the replacement text.

Use Cases

  • Update names in filled tax forms
  • Replace addresses in PDF documents
  • Update dates or reference numbers
  • Batch update form field values

Requirements

  • PDF must have fillable form fields (not flattened)
  • Python 3.7+
  • pypdf library

Usage

Basic Usage

python /app/uploads/skills/public/pdf-text-replace/scripts/replace_text_in_pdf.py \
    /app/uploads/input.pdf \
    "OLD TEXT" \
    "NEW TEXT" \
    /app/uploads/output.pdf

Example: Replace Name in Tax Form

python /app/uploads/skills/public/pdf-text-replace/scripts/replace_text_in_pdf.py \
    /app/uploads/f5472.pdf \
    "MANISH KUMAR" \
    "MANNU KUMAR" \
    /app/uploads/f5472_updated.pdf

Script Details

Script: scripts/replace_text_in_pdf.py

Arguments:

  1. input_pdf - Path to input PDF file
  2. search_text - Text to search for in form fields
  3. replace_text - Text to replace with
  4. output_pdf - Path to save the updated PDF

Output:

  • Creates a new PDF with updated field values
  • Preserves all form fields (not flattened)
  • Reports number of fields modified

Limitations

  • Only works with fillable PDF forms (not scanned/image PDFs)
  • Replaces text in form field values, not static text
  • Case-sensitive search by default
  • Cannot modify flattened PDFs

Dependencies

The script requires the pypdf library, which is included in the container requirements.

Error Handling

The script will report errors if:

  • Input PDF doesn't exist
  • PDF doesn't have fillable form fields
  • Search text is not found
  • Output path is not writable