How to Change Page Margins of a PDF Using Python

In document processing scenarios, we may encounter the need to adjust the blank edges (margins) of PDF files, such as reserving blank space for printing, cropping excess white edges, or unifying document layout formats. There are several PDF processing libraries in the Python ecosystem. This article uses Free Spire.PDF for Python to implement pure-code, watermark-free, and lightweight PDF margin increase and decrease operations.

This solution requires no complex dependencies. Through the core logic of creating a new PDF document, reconstructing page sizes, and redrawing pages using templates, it precisely controls the blank edges on all four sides (top, bottom, left, and right) of a PDF, and is suitable for single-page and multi-page PDF documents.

1. Setup the Environment

First, install the required third-party library. Free Spire.PDF for Python focuses on basic PDF editing, with a concise and easy-to-understand API, making it suitable for rapid development. Run the following pip command to complete the installation:

pip install spire.pdf

2. Overview of Implementation Principles

The core logic of the two margin adjustment methods in this article is the same; only the size calculation and drawing parameters differ:

• Increase margins : Expand the PDF page size, keep the original page content centered, and use the newly added blank area as margins.
• Decrease margins : Shrink the PDF page size, and crop the blank edges of the original page by offsetting the content drawing coordinates.

General workflow: Load the original PDF → Calculate the new page size → Iterate through pages to generate templates → Create new pages and redraw content → Save the new file and release resources.

3. Increase PDF Page Margins in Python

This scenario is suitable for situations where PDF content is too close to the edges, where printing whitespace needs to be added, or where document margin specifications need to be unified. Below is simplified, directly runnable code where you can customize the margin increments for the top, bottom, left, and right sides.

from spire.pdf.common import SizeF
from spire.pdf import PdfDocument

# 1. Load the original PDF document
original_pdf = PdfDocument()
original_pdf.LoadFromFile("sample.pdf")

# 2. Customize the margins to be added on all four sides
margin_top = 40
margin_bottom = 40
margin_left = 40
margin_right = 40

# 3. Calculate the new page size based on the first page size (applicable to all pages)
first_page = original_pdf.Pages[0]
new_page_width = first_page.Size.Width + margin_left + margin_right
new_page_height = first_page.Size.Height + margin_top + margin_bottom
new_page_size = SizeF(new_page_width, new_page_height)

# 4. Create a new PDF document and redraw all pages
new_pdf = PdfDocument()
for page_idx in range(original_pdf.Pages.Count):
    # Generate a template of the original page, preserving the complete content
    page_template = original_pdf.Pages[page_idx].CreateTemplate()
    # Add a new page with the custom size
    new_page = new_pdf.Pages.Add(new_page_size)
    # Draw the original content at the origin of the new page, automatically generating uniform whitespace
    page_template.Draw(new_page, 0.0, 0.0)

# 5. Save the file and release resources
new_pdf.SaveToFile("increase_pdf_margins.pdf")
original_pdf.Dispose()
new_pdf.Dispose()
print("PDF margin increase completed!")

Core explanation : By adding the four margin values to the original page width and height, the page size is expanded. The original content is fully preserved at the top-left corner of the page, and the remaining area automatically forms uniform blank margins.

4. Decrease PDF Page Margins in Python

This scenario is commonly used to remove excess default blank edges from PDFs, compress the visible document size, and make the content display close to the edges. The core is to shrink the page size while offsetting the content drawing coordinates in the opposite direction to crop excess whitespace.

from spire.pdf.common import SizeF, PdfMargins
from spire.pdf import PdfDocument

# 1. Load the original PDF document
original_pdf = PdfDocument()
original_pdf.LoadFromFile("sample.pdf")

# 2. Customize the blank margins to be cropped on all four sides
reduce_top = 20.0
reduce_bottom = 20.0
reduce_left = 20.0
reduce_right = 20.0

# 3. Calculate the new page size after cropping
first_page = original_pdf.Pages[0]
new_page_width = first_page.Size.Width - reduce_left - reduce_right
new_page_height = first_page.Size.Height - reduce_top - reduce_bottom
new_page_size = SizeF(new_page_width, new_page_height)

# 4. Create a new PDF document, redraw and crop page whitespace
new_pdf = PdfDocument()
for page_idx in range(original_pdf.Pages.Count):
    page_template = original_pdf.Pages[page_idx].CreateTemplate()
    # Add a new page with no margins
    new_page = new_pdf.Pages.Add(new_page_size, PdfMargins(0.0))
    # Offset the drawing coordinates in the opposite direction to crop the original blank edges
    page_template.Draw(new_page, -reduce_left, -reduce_top)

# 5. Save the file and release resources
new_pdf.SaveToFile("decrease_pdf_margins.pdf")
original_pdf.Dispose()
new_pdf.Dispose()
print("PDF margin cropping completed!")

Core explanation : Subtract the whitespace size to be cropped from the page size, and at the same time offset the content drawing coordinates to the left and upward, so that the original page's edge whitespace extends beyond the new page range, thereby achieving the white edge cropping effect.

5. Key Notes

• Unit description : All margin values in the code use the standard PDF unit (points). 1 inch ≈ 72 points, and they can be freely converted and adjusted as needed.
• Multi-page adaptation : The code uses a globally uniform margin rule, so all pages apply the same increase or decrease parameters, making it suitable for standardized document processing.
• Resource release : The Dispose() method must be called to release document resources and avoid memory usage buildup.
• Parameter threshold : When decreasing margins, the cropping value must not exceed the original page whitespace; otherwise, the content may be abnormally cropped.

6. Summary

With Free Spire.PDF for Python, custom adjustment of PDF margins can be implemented in a minimal and efficient way, without relying on Adobe software or complex PDF parsing algorithms. The two sets of code provided in this article respectively cover the two high-frequency scenarios of increasing whitespace and cropping white edges . The code is concise, with complete comments, and can be directly embedded into automated document processing scripts, office tools, and batch processing programs.