12.0.0 (unreleased)¶
Security¶
TODO¶
TODO
CVE YYYY-XXXXX: TODO¶
TODO
Backwards incompatible changes¶
Python 3.9¶
Pillow has dropped support for Python 3.9, which reached end-of-life in October 2025.
ImageFile.raise_oserror¶
ImageFile.raise_oserror() has been removed. The function was undocumented and was
only useful for translating error codes returned by a codec’s decode() method,
which ImageFile already did automatically.
IptcImageFile helper functions¶
The functions IptcImageFile.dump and IptcImageFile.i, and the constant
IptcImageFile.PAD have been removed. These were undocumented helper functions
intended for internal use, so there is no replacement. They can each be replaced by a
single line of code using builtin functions in Python.
ImageCms constants and versions() function¶
A number of constants and a function in ImageCms have been removed. This
includes a table of flags based on LittleCMS version 1 which has been replaced with a
new class ImageCms.Flags based on LittleCMS 2 flags.
Deprecated |
Use instead |
|---|---|
|
No replacement |
|
|
|
|
|
|
|
No replacement |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ImageMath eval()¶
ImageMath.eval() has been removed. Use lambda_eval() or
unsafe_eval() instead.
BGR;15, BGR 16 and BGR;24¶
The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
Non-image modes in ImageCms¶
The use in ImageCms of input modes and output modes that are not Pillow
image modes has been removed. Defaulting to “L” or “1” if the mode cannot be mapped has
also been removed.
Support for LibTIFF earlier than 4¶
Support for LibTIFF earlier than version 4 has been removed. Upgrade to a newer version of LibTIFF instead.
ImageDraw.getdraw hints parameter¶
The hints parameter in getdraw() has been removed.
FreeType 2.9.0¶
Support for FreeType 2.9.0 has been removed. FreeType 2.9.1 is the minimum version supported.
We recommend upgrading to at least FreeType 2.10.4, which fixed a severe vulnerability introduced in FreeType 2.6 (CVE 2020-15999).
Deprecations¶
Image._show¶
Image._show has been deprecated, and will be removed in Pillow 13 (2026-10-15).
Use show() instead.
ImageCms.ImageCmsProfile.product_name and .product_info¶
ImageCms.ImageCmsProfile.product_name and the corresponding
.product_info attributes have been deprecated, and will be removed in
Pillow 13 (2026-10-15). They have been set to None since Pillow 2.3.0.
API changes¶
TODO¶
TODO
API additions¶
TODO¶
TODO
Other changes¶
Python 3.14¶
Pillow 11.3.0 had wheels built against Python 3.14 beta, available as a preview to help others prepare for 3.14, and to ensure Pillow could be used immediately at the release of 3.14.0 final (2025-10-07, PEP 745).
Pillow 12.0.0 now officially supports Python 3.14.
Image.fromarray mode parameter¶
In Pillow 11.3.0, the mode parameter in fromarray() was
deprecated. Part of this functionality has been restored in Pillow 12.0.0. Since pixel
values do not contain information about palettes or color spaces, the parameter can be
used to place grayscale L mode data within a P mode image, or read RGB data as YCbCr
for example.
ImageMorph operations must have length 1¶
Valid ImageMorph operations are 4, N, 1 and M. By limiting the length to 1 character within Pillow, long execution times can be avoided if a user provided long pattern strings. Reported by Jang Choi.