NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #187 most downloaded on PyPI
A pure-python PDF library capable of splitting, merging, cropping, and transforming PDF files
Latest stable
7.1.1
Last release 2 days ago
18 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 56 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
131 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Add PDF/A XMP metadata support (#3314) by @Arya-A-Nair
Add basic support for JBIG2 by using jbig2dec (#3163) by @stefan6419846
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for IndirectObject.__iter__ (#3228) by @bryan-brancotte
Add support for IndirectObject.__contains__ (#3155) by @noamkush
IndirectObject.__contains__ (#3155) by @noamkushIndirectObject.__contains__ (#3155)Use the correct name StandardEncoding for the predefined cmap (#3156) by @stefan6419846
EI sequences (#3152) by @stefan6419846EI sequences (#3152)Handle attachments in /Kids and provide object-oriented API (#3108) by @stefan6419846
pytest.warns() (#3083) by @mgornypytest.warns() (#3083)Deprecate with replacement CCITParameters (#3019) by @j-t-1
add_metadata can deal with _info = None (#3040) by @xmo-odoostr.__new__ in TextStringObject (#2952) by @thomas-forteContentStream.operations (#2941) by @kmurphy4add_metadata can deal with _info = None (#3040)str.__new__ in TextStringObject (#2952)ContentStream.operations (#2941)Add layout_mode_font_height_weight argument to PageObject.extract_text() (#2920) by @hpierre001
layout_mode_font_height_weight argument to PageObject.extract_text() (#2920) by @hpierre001layout_mode_font_height_weight argument to PageObject.extract_text() (#2920)Add full parameter to PdfWriter constructor
full parameter to PdfWriter constructor (#2865)Remove the deprecated PdfMerger and AnnotationBuilder classes and other deprecations cleanup
This version drops support for Python 3.7 (not maintained since July 2023), PdfMerger (use PdfWriter instead) and AnnotationBuilder (use annotations instead).
Add deprecate_with_replacement to StreamObject.initializeFromD…
Fix deprecation for Ressources when using old constants (#2705) by @stefan6419846
Allow multiple charsets for NameObject.read_from_stream (#2585) by @pubpub-zz
Generating name objects (NameObject) without a leading slash is considered deprecated now. Previously, just a plain warning would be logged, leading t…
Generating name objects (NameObject) without a leading slash is considered deprecated now. Previously, just a plain warning would be logged, leading to possibly invalid PDF files. According to our deprecation policy, this will log a DeprecationWarning for now.
Generating name objects (NameObject) without a leading slash
is considered deprecated now. Previously, just a plain warning
would be logged, leading to possibly invalid PDF files. According
to our deprecation policy, this will log a DeprecationWarning
for now.
Use NumberObject for /Border elements of annotations (#2451) by @rsinger417
Polyline \xe2\x86\x92 PolyLine in adding-pdf-annotations.md (#2426) by @CWKSClayout mode text extraction ZeroDivisionError (#2417) by @shartzog
We deprecated a lot of the old PyPDF2 API that was either not following PEP8 naming styles or was not using a property. Users coming from PyPDF2 might…
pypdf==4.0.0 is a big milestone forward:
A big 'Thank you!' the the whole pypdf community for your work. Thanks to you, pypdf is better than ever.
Kudos to @shartzog who added the layout-mode with his first contribution!
Handle IndirectObject as image filter (#2355) by @stefan6419846
Out-of-bounds issue in handle_tj (text extraction) (#2342) by @rgwood-rely
Cope with deflated images with CMYK Black Only (#2322) by @pubpub-zz
disallow_any_generics and add missing generics (#2278) by @nilehmannMediabox expansion size when applying non-right angle rotation (#2282) by @MrinalJain17
Infinite recursion when using PdfWriter(clone_from=reader) (#2264) by @Alexhuszagh
Avoid exceeding recursion depth when retrieving image mode (#2251) by @stefan6419846
invalid cm/tm in visitor functions (#2206) by @pubpub-zz
PDF size increases because of too high float writing precision (#2213) by @pubpub-zz
Missing new line in extract_text with cm operations (#2142) by @pubpub-zz
cryptography as default (#2186) by @exiledkingcc⚠️ The 'rename PdfWriter.create_viewer_preference to PdfWriter.create_viewer_preferences (#2190)' could be a breaking change for you, if you use it. As it was only introduced last week I'm confident enough that nobody will be affected though. Hence only the patch update.
Cope with indirect objects in filters and remove deprecated code
Cope with missing /I in articles
Relax typing_extensions version
Check version of crypt provider
Avoid endless recursion of reading damaged PDF file
optimize _decode_png_prediction
Add level parameter to compress_content_streams
level parameter to compress_content_streams (#2044)ASCIIHexDecode.decode now returns bytes instead of str (#1994) :warning: This could be a breaking change for people who directly use ASCIIHexDecode. I…
cryptography for encryption/decryption as a fallback for PyCryptodome (#2000)Add is_open in outlines in PdfReader and PdfWriter
Accept calRGB and calGray color_spaces (#1968) by @pubpub-zz
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.12.1...3.12.2
Prevent updating page contents after merging page (stamping/watermarking) (#1952) by @pubpub-zz
We finally fully support modern cryptography for encrypting and decrypting PDF files. A big thank you to @exiledkingcc who did this work a while a go
We finally fully support modern cryptography for encrypting and decrypting PDF files. A big thank you to @exiledkingcc who did this work a while a go 🙏
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.11.1...3.12.0
Cascaded filters in image objects (#1913) by @pubpub-zz
Add page_number property (#1856) by @pubpub-zz
This release is focused around improving pypdf's capabilities around handling images, but pypdf should now also deal better with forms.
This release is focused around improving pypdf's capabilities around handling images, but pypdf should now also deal better with forms.
A big thank you to @pubpub-zz who went above and beyond in this release :clap: :hugs:
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.9.1...3.10.0
Deprecate PdfMerger (#1866) by @pubpub-zz
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.9.0...3.9.1
Simplify metadata input (Document Information Dictionary) (#1851) by @pubpub-zz
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.8.1...3.9.0
Convert color space before saving
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.8.0...3.8.1
Mark code handling old parameters as deprecated
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.7.1...3.8.0
Warn about PDF encryption security
tox -e deps (#1750, #1752) by @adehadFull Changelog: https://github.com/py-pdf/pypdf/compare/3.7.0...3.7.1
tox -e deps (#1750, #1752)Use Python's secrets module instead of random module
Extend PdfWriter.append() to PageObjects (#1704) by @pubpub-zz
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.5.2...3.6.0
compress_content_stream not readable in Adobe Acrobat (#1698) by @pubpub-zz
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.5.1...3.5.2
⚠️ We discovered that compress_content_stream has to be applied to a page of the PdfWriter. It may not be applied to a page of the PdfReader!
Some attributes not copied in DictionaryObject._clone (#1635) by @pubpub-zz
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.5.0...3.5.1
Add reader.attachments public interface (#1611, #1661) by @pubpub-zz
clone_document_from_reader() (#1613) by @pubpub-zzFull Changelog: https://github.com/py-pdf/pypdf/compare/3.4.1...3.5.0
clone_document_from_reader() (#1613)Switch from trimbox to cropbox when merging pages
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.4.0...3.4.1
NOTICE: pypdf changed the way it represents numbers parsed from PDF files. pypdf<3.4.0 represented numbers as Decimal, pypdf>=3.4.0 represents them as
Version 3.4.0, 2023-02-05
NOTICE: pypdf changed the way it represents numbers parsed from PDF files. pypdf<3.4.0 represented numbers as Decimal, pypdf>=3.4.0 represents them as floats. Several other PDF libraries to this, as well as many PDF viewers. We hope to fix issues with too high precision like this and get a speed boost. In case your PDF documents rely on more than 18 decimals of precision you should check if it still works as expected. To clarify: This does not affect the text shown in PDF documents, even if the text are numbers. It affects numbers used by the PDF document, e.g. when graphics are drawn on the PDF or very exact positions are used. Typically, 5 decimals should be enough.
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.3.0...3.4.0
NOTICE: pypdf changed the way it represents numbers parsed from PDF files. pypdf<3.4.0 represented numbers as Decimal, pypdf>=3.4.0 represents them as floats. Several other PDF libraries to this, as well as many PDF viewers. We hope to fix issues with too high precision like this and get a speed boost. In case your PDF documents rely on more than 18 decimals of precision you should check if it still works as expected. To clarify: This does not affect the text shown in PDF documents. It affects numbers, e.g. when graphics are drawn on the PDF or very exact positions are used. Typically, 5 decimals should be enough.
Add page label support to PdfWriter (#1558) by @lorenzomanini
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.2.1...3.3.0
Accept hierarchical fields (#1529) by @pubpub-zz
Help the specializing adpative interpreter
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.1.0...3.2.0
Move PyPDF2 to pypdf (#1513). This now it's all lowercase, no number in the name. For installation and for import. PyPDF2 will no longer receive updat
Move PyPDF2 to pypdf (#1513). This now it's all lowercase, no number in the name. For installation and for import. PyPDF2 will no longer receive updates. The community should move back to its roots (pydf).
Full Changelog: https://github.com/py-pdf/pypdf/compare/3.0.0...3.1.0
Move PyPDF2 to pypdf (#1513). This now it's all lowercase, no number in the name. For installation and for import. PyPDF2 will no longer receive updates. The community should move back to its roots.
If you were still using pyPdf or PyPDF2 < 2.0.0, I recommend reading the migration guide: https://pypdf.readthedocs.io/en/latest/user/migration-1-to-2.html
pypdf==3.1.0 is only different from PyPDF2==3.0.0 in the package name.
Replacing "PyPDF2" by "pypdf" should be enough if you migrate from
PyPDF2==3.0.0 to pypdf==3.1.0.
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.