Pillow is the actively maintained fork of PIL, the Python Imaging Library, which stopped at version 1.1.7 in 2009.
Install it with pip install pillow and import it as from PIL import Image. The latest version is
13.0.0 (released 2026-10-16). Pillow releases every quarter, and each October brings a new major
version that removes deprecated APIs and drops the oldest Python.
PIL vs Pillow
PIL was written by Fredrik Lundh from 1995. When it stopped being updated, Alex Clark and contributors forked it in 2010 as
Pillow, keeping the PIL package name so existing code kept working. PIL itself never supported Python 3 and cannot
be installed today; every “PIL” tutorial, answer and error message really means Pillow.
import importlib.metadata
import PIL
print("distribution name on PyPI:", importlib.metadata.metadata("pillow")["Name"])
print("import name:", PIL.__name__)
print("licence:", importlib.metadata.metadata("pillow").get("License-Expression")
or importlib.metadata.metadata("pillow").get("License"))
try:
import Image # how the original PIL was imported
except ModuleNotFoundError as e:
print("import Image:", e)
distribution name on PyPI: pillow
import name: PIL
licence: MIT-CMU
import Image: No module named 'Image'
So: pip install pillow (any capitalisation), from PIL import Image (capital PIL), and never both
PIL and Pillow in the same environment. If the import fails, see
No module named 'PIL' or
module 'PIL' has no attribute 'Image'.
Which version do you have, and what is built in?
import sys
import PIL
from PIL import Image, features
print("Pillow", PIL.__version__, "on Python", sys.version.split()[0])
print("imported from:", PIL.__file__.rsplit("PIL", 1)[0])
for name in ["libjpeg_turbo", "zlib", "webp", "avif", "freetype2", "littlecms2", "raqm"]:
print(f" {name:<14} {features.version(name) or 'not available'}")
Image.init()
print(len(Image.OPEN), "formats can be opened,", len(Image.SAVE), "can be saved")
Pillow 13.0.0 on Python 3.13.17
imported from: /home/you/.venv/lib/python3.13/site-packages/
libjpeg_turbo 3.2.0
zlib 1.3
webp 1.6.0
avif 1.4.2
freetype2 2.14.3
littlecms2 2.19
raqm 0.11.0
43 formats can be opened, 30 can be saved
PIL.__version__ is the version, and PIL.features tells you which optional libraries the install
includes. A missing entry explains errors such as decoder jpeg not available or text without Arabic shaping. The
full report is python -m PIL.report. To upgrade: python -m pip install --upgrade pillow; for every
installation method see installing Pillow.
Latest version and release schedule
In Pillow's own words: “Pillow is released quarterly on January 2nd, April 1st, July 1st and October 15th.” Every release bumps at least the minor version; the October release is usually a new major version, because that is when deprecated APIs are removed and the oldest Python version is dropped, following Python's own end-of-life schedule. Patch releases (such as 12.1.1) appear between them for security fixes and severe bugs.
Major versions and what they changed (changelog)
Major versions are where upgrades break code. The Python requirement is what each release declares on PyPI; Pillow 13.0.0 supports Python 3.11, 3.12, 3.13, 3.14 and 3.15.
| Version | Released | Requires Python | What changed |
|---|---|---|---|
| 13.0.0 | 2026-10-16 | >=3.11 | Python 3.11 to 3.15; Python 3.10 dropped. MKS2013 and MKS2021 resampling filters. Saving mode I as PNG raises an error. invert, posterize and solarize accept palette images. ImageCms profile product_name/product_info removed. Faster text rendering and ImageCms. |
| 12.0.0 | 2025-10-15 | >=3.10 | Python 3.9 dropped, 3.14 supported. ImageMath.eval() removed (use lambda_eval() or unsafe_eval()). ImageText.Text added. FreeType 2.9.0 support removed. |
| 11.0.0 | 2024-10-15 | >=3.9 | Python 3.8 dropped, 3.13 supported. PyAccess and PSFile removed. 16-bit images resize with BICUBIC by default instead of NEAREST. |
| 10.0.0 | 2023-07-01 | >=3.8 | Image.ANTIALIAS, LINEAR and CUBIC removed; textsize() and getsize() removed. 32-bit wheels no longer provided. Python 3.7 no longer supported. |
| 9.0.0 | 2022-01-02 | >=3.7 | Python 3.6 dropped. PILLOW_VERSION removed (use __version__). Wheels switched to libjpeg-turbo. GIF frames after the first open as RGB or RGBA. |
The changes that break the most code are in 10.0.0: removing Image.ANTIALIAS gives
module 'PIL.Image' has no attribute 'ANTIALIAS', and removing
textsize() gives 'ImageDraw' object has no attribute 'textsize'.
The newest Pillow for each Python version is listed in which
Pillow for which Python.
Notable minor releases
| Version | Released | Added |
|---|---|---|
| 12.3.0 | 2026-07-01 | ImageGrab.grab(scale_down=) for Retina screenshots; a batch of security fixes. |
| 12.2.0 | 2026-04-01 | ImageText.Text.wrap(): word wrap, shrink or grow text to fit a box. |
| 11.3.0 | 2025-07-01 | AVIF support included in the wheels (not on Windows ARM64 or iOS). |
| 11.2.1 | 2025-04-12 | 11.2.0 was withdrawn; 11.2.1 added AVIF for source builds and justify alignment for multiline text. |
| 10.4.0 | 2024-07-01 | ImageDraw.circle(). |
| 10.1.0 | 2023-10-15 | load_default() returns a scalable font (Aileron); ImageOps.cover(); Python 3.12. |
| 9.4.0 | 2023-01-02 | Short constants such as Image.LANCZOS un-deprecated (no need for Image.Resampling). |
| 9.1.0 | 2022-04-01 | Image.Resampling and the other enums added; BigTIFF reading. |
Version 11.2.0 does not exist on PyPI: its release was stopped part-way because the new wheels hit PyPI's project size limit, and 11.2.1 replaced it.
Security vulnerabilities and fixes
Pillow parses untrusted files written in dozens of formats, so most releases fix security bugs. Recent examples from the release notes:
- 13.0.0 (2026-10-16): several fixes, including a double free in
Image.transform()and a crash inquantize() - 12.3.0 (2026-07-01): decompression-bomb limits for PDF and GD, out-of-bounds writes in
crop(),paste()andRankFilter, and more - 12.2.0 (2026-04-01): FITS decompression bomb, PDF trailer infinite loop, font integer overflow
- 12.1.1 (2026-02-11): CVE-2026-25990: negative tile offsets could write out of bounds
- 11.3.0 (2025-07-01): CVE-2025-48379: heap buffer overflow when writing large DDS images
- 10.2.0 (2024-01-02): CVE-2023-50447: arbitrary code through
ImageMath.eval()environment keys
If your application opens images from users or the internet, stay on the newest release and set a pixel limit (see
DecompressionBombError and
handling uploads safely). Pinning
pillow>=10 or a range such as pillow>=12,<14 in your requirements keeps fixes coming while
avoiding an untested major version.
License (MIT-CMU), PyPI, GitHub and Pillow-SIMD
- License: “Like PIL, Pillow is licensed under the open source MIT-CMU License”, a permissive licence that allows commercial use provided the copyright and permission notice are kept.
- Official homes: documentation at pillow.readthedocs.io, releases on PyPI, and source and issues on GitHub (python-pillow/Pillow). This site is independent of the project.
- Pillow-SIMD is a separate fork with SIMD-optimised resizing and filters, installed instead of Pillow. Its newest release on PyPI is 12.1.1.post0 (2026-09-15), so it trails Pillow by a major version; check that the features you need exist in it.
- Not Pillow's job: computer vision, video and GPU processing belong to other libraries; see Pillow vs OpenCV and other libraries.
Sources
What this page shows comes from running its code with Pillow 13.0.0. The API details and version history were checked against these primary sources:
- Pillow release notes (all versions)
- Pillow versioning policy
- Pillow on PyPI (releases and wheels)
- Pillow: Python version support
- Pillow 13.0.0 release notes
Related
The outputs and images on this page are the real results of running every example with Pillow 13.0.0 on Python 3.13 (Linux) on 2026-10-29. Every example is also re-run automatically on macOS (Darwin 25.6.0, Pillow 12.3.0), Linux (Linux 6.17.0-1022-azure, Pillow 12.3.0), Windows (Windows 2025Server, Pillow 12.3.0); the line under each example shows the result per operating system. The DejaVu Sans font files sit next to each script so font examples behave the same everywhere. Sample photos: NASA/Sam Lott, public domain. Spotted something wrong? Tell us.