How To Print PDF Files Using Python

What Is IronPDF and How Does It Help with PDF Printing?

IronPDF is a Python library that enables developers to generate, manipulate, and convert PDF documents. The library's printing support covers two patterns: direct default-printer output with a single method call, and document-level access to PrinterSettings for complete printer control.

With IronPDF, the underlying complexity of printer communication is handled by the library. Developers work with a high-level API instead of managing OS-level print spooler interactions, subprocess commands, or platform-specific print utilities. This means the same Python code works on Windows, Linux, and macOS without modification.

A key capability is the ability to convert HTML, CSS, and JavaScript into PDF before printing — useful when the source material is a web template or dynamic report rather than an existing file. For more on this, see the HTML to PDF tutorial. The library also supports merging PDFs before printing and compressing PDFs to reduce spool transfer time for large documents.

How Do I Install IronPDF for Python?

The IronPDF package is available on PyPI and installs with a single pip command.

 pip install ironpdf

After installation, add the import statement at the top of your script:

from ironpdf import *

from ironpdf import *

IronPDF requires Python 3.6 or later. The package automatically downloads the IronPDF rendering engine on first use, so the initial import may take a moment. For environments with restricted outbound access, see the IronPDF Engine configuration guide for offline setup options.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

How Do I Load a PDF File for Printing?

Loading a PDF from the filesystem into a PdfDocument object using IronPDF for Python.

IronPDF loads PDF files from the filesystem using PdfDocument.FromFile(). The method accepts a file path string and returns a PdfDocument object ready for printing, manipulation, or inspection.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load from a file path
pdf = PdfDocument.FromFile("MyPdf.pdf")

# Load from bytes (e.g., a file read from a database or HTTP response)
with open("MyPdf.pdf", "rb") as f:
    pdf_bytes = f.read()
pdf_from_bytes = PdfDocument.FromBytes(pdf_bytes)

# Load a password-protected PDF
protected_pdf = PdfDocument.FromFile("SecurePdf.pdf", "password123")

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load from a file path
pdf = PdfDocument.FromFile("MyPdf.pdf")

# Load from bytes (e.g., a file read from a database or HTTP response)
with open("MyPdf.pdf", "rb") as f:
    pdf_bytes = f.read()
pdf_from_bytes = PdfDocument.FromBytes(pdf_bytes)

# Load a password-protected PDF
protected_pdf = PdfDocument.FromFile("SecurePdf.pdf", "password123")

The code above demonstrates three loading patterns. FromFile() is the most common for file-system workflows. FromBytes() is useful when the PDF arrives as binary data from a database query or API response. The optional password parameter in FromFile() handles encrypted PDFs without any additional decryption step.

For PDFs sourced from a URL or HTML content, IronPDF can also convert a URL to PDF or render an HTML file to PDF before printing.

How Do I Print a PDF Using Default Settings?

A Python script using IronPDF's `Print()` method sends a PDF job to the system default printer.

The Print() method sends the document to the system's default printer using default page settings. No additional configuration is needed.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load the PDF
pdf = PdfDocument.FromFile("invoice.pdf")

# Print to default printer with default settings
pdf.Print()

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

# Load the PDF
pdf = PdfDocument.FromFile("invoice.pdf")

# Print to default printer with default settings
pdf.Print()

Default settings use the system's configured default printer, print all pages, apply the printer's own default paper size and orientation, and send one copy. This is the right choice for simple workflows where the user's printer configuration already matches the document requirements.

For production code, wrap the print call in error handling to catch printer-offline or permission errors:

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

try:
    pdf = PdfDocument.FromFile("invoice.pdf")
    pdf.Print()
except Exception as e:
    print(f"Print job failed: {e}")

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

try:
    pdf = PdfDocument.FromFile("invoice.pdf")
    pdf.Print()
except Exception as e:
    print(f"Print job failed: {e}")

The exception message provides OS-level detail about the print failure — for example, whether the printer is offline, the spooler is paused, or the document failed to render.

How Do I Customize Print Settings Before Printing?

IronPDF's `GetPrintDocument()` method returns a PrintDocument object with full access to PrinterSettings properties.

GetPrintDocument() returns a PrintDocument object that exposes the full PrinterSettings API. This allows selecting a named printer, setting page ranges, controlling copies and collation, and configuring duplex mode before sending the job.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

pdf = PdfDocument.FromFile("quarterly-report.pdf")

# Access the PrintDocument object
printer_setting = pdf.GetPrintDocument()

# Select a specific printer by name
printer_setting.PrinterSettings.PrinterName = "HP LaserJet Pro"

# Print only pages 2 through 4
printer_setting.PrinterSettings.FromPage = 2
printer_setting.PrinterSettings.ToPage = 4

# Print 2 collated copies
printer_setting.PrinterSettings.Copies = 2
printer_setting.PrinterSettings.Collate = True

# Execute the print job
printer_setting.Print()

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

pdf = PdfDocument.FromFile("quarterly-report.pdf")

# Access the PrintDocument object
printer_setting = pdf.GetPrintDocument()

# Select a specific printer by name
printer_setting.PrinterSettings.PrinterName = "HP LaserJet Pro"

# Print only pages 2 through 4
printer_setting.PrinterSettings.FromPage = 2
printer_setting.PrinterSettings.ToPage = 4

# Print 2 collated copies
printer_setting.PrinterSettings.Copies = 2
printer_setting.PrinterSettings.Collate = True

# Execute the print job
printer_setting.Print()

The PrinterSettings.PrinterName property accepts the printer's display name as it appears in the OS printer list. On Windows, this matches the name shown in "Devices and Printers". On Linux, it corresponds to the CUPS printer name. Setting an invalid printer name will cause the print job to fail at runtime, so validate the name against the installed printer list when building user-facing print dialogs.

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

def batch_print(file_paths):
    for path in file_paths:
        try:
            pdf = PdfDocument.FromFile(path)
            pdf.Print()
        except Exception as e:
            print(f"Failed to print {path}: {e}")

batch_print(["invoice_001.pdf", "invoice_002.pdf", "shipping_label.pdf"])

from ironpdf import *

License.LicenseKey = "YOUR-LICENSE-KEY"

def batch_print(file_paths):
    for path in file_paths:
        try:
            pdf = PdfDocument.FromFile(path)
            pdf.Print()
        except Exception as e:
            print(f"Failed to print {path}: {e}")

batch_print(["invoice_001.pdf", "invoice_002.pdf", "shipping_label.pdf"])

What Are the Next Steps for Python PDF Printing?

This guide covered the two core printing patterns in IronPDF for Python: default-printer output with pdf.Print() and custom-settings output with pdf.GetPrintDocument(). Both approaches work on Windows, Linux, and macOS with no platform-specific code.

To extend these patterns in a production application, consider:

• Filling PDF forms before printing to produce completed documents from templates
• Adding watermarks or digital signatures before sending to the printer
• Converting HTML to PDF for dynamic report printing from web templates
• Extracting text from printed documents for audit logging

Start with a free trial license to test printing in your environment. Licensing options start from $999 for production deployment.

Download the full source code used in this guide.