Deprecations and removals
- Deprecated features
  - PILLOW_VERSION constant
  - ImageCms.CmsProfile attributes
- Removed features

Deprecations and removals

This page lists Pillow features that are deprecated, or have been removed inpast major releases, and gives the alternatives to use instead.

Deprecated features

Below are features which are considered deprecated. Where appropriate,a DeprecationWarning is issued.

PILLOW_VERSION constant

Deprecated since version 5.2.0.

PILLOWVERSION has been deprecated and will be removed in a future release. Use_version instead.

It was initially removed in Pillow 7.0.0, but brought back in 7.1.0 to give projectsmore time to upgrade.

ImageCms.CmsProfile attributes

Deprecated since version 3.2.0.

Some attributes in ImageCms.CmsProfile are deprecated. From 6.0.0, they issue aDeprecationWarning:

Deprecated	Use instead
`color_space`	Padded `xcolor_space`
`pcs`	Padded `connection_space`
`product_copyright`	Unicode `copyright`
`product_desc`	Unicode `profile_description`
`product_description`	Unicode `profile_description`
`product_manufacturer`	Unicode `manufacturer`
`product_model`	Unicode `model`

Removed features

Deprecated features are only removed in major releases after an appropriateperiod of deprecation has passed.

Python 2.7

Removed in version 7.0.0.

Python 2.7 reached end-of-life on 2020-01-01. Pillow 6.x was the last series tosupport Python 2.

Image.del

Removed in version 7.0.0.

Implicitly closing the image’s underlying file in Image.del has been removed.Use a context manager or call Image.close() instead to close the file in adeterministic way.

Previous method:

im = Image.open("hopper.png")
im.save("out.jpg")

Use instead:

with Image.open("hopper.png") as im:
    im.save("out.jpg")

PIL.*ImagePlugin.version attributes

Removed in version 7.0.0.

The version constants of individual plugins have been removed. Use PIL.versioninstead.

Removed	Removed	Removed
`BmpImagePlugin.version`	`Jpeg2KImagePlugin.version`	`PngImagePlugin.version`
`CurImagePlugin.version`	`JpegImagePlugin.version`	`PpmImagePlugin.version`
`DcxImagePlugin.version`	`McIdasImagePlugin.version`	`PsdImagePlugin.version`
`EpsImagePlugin.version`	`MicImagePlugin.version`	`SgiImagePlugin.version`
`FliImagePlugin.version`	`MpegImagePlugin.version`	`SunImagePlugin.version`
`FpxImagePlugin.version`	`MpoImagePlugin.version`	`TgaImagePlugin.version`
`GdImageFile.version`	`MspImagePlugin.version`	`TiffImagePlugin.version`
`GifImagePlugin.version`	`PalmImagePlugin.version`	`WmfImagePlugin.version`
`IcoImagePlugin.version`	`PcdImagePlugin.version`	`XbmImagePlugin.version`
`ImImagePlugin.version`	`PcxImagePlugin.version`	`XpmImagePlugin.version`
`ImtImagePlugin.version`	`PdfImagePlugin.version`	`XVThumbImagePlugin.version`
`IptcImagePlugin.version`	`PixarImagePlugin.version`

PyQt4 and PySide

Removed in version 7.0.0.

Qt 4 reached end-of-life on 2015-12-19. Its Python bindings are also EOL: PyQt4 since2018-08-31 and PySide since 2015-10-14.

Support for PyQt4 and PySide has been removed from ImageQt. Please upgrade to PyQt5or PySide2.

Setting the size of TIFF images

Removed in version 7.0.0.

Setting the size of a TIFF image directly (eg. im.size = (256, 256)) throwsan error. Use Image.resize instead.

VERSION constant

Removed in version 6.0.0.

VERSION (the old PIL version, always 1.1.7) has been removed. Useversion instead.

Undocumented ImageOps functions

Removed in version 6.0.0.

Several undocumented functions in ImageOps have been removed. Use the equivalentsin ImageFilter instead:

Removed	Use instead
`ImageOps.box_blur`	`ImageFilter.BoxBlur`
`ImageOps.gaussian_blur`	`ImageFilter.GaussianBlur`
`ImageOps.gblur`	`ImageFilter.GaussianBlur`
`ImageOps.usm`	`ImageFilter.UnsharpMask`
`ImageOps.unsharp_mask`	`ImageFilter.UnsharpMask`

PIL.OleFileIO

Removed in version 6.0.0.

PIL.OleFileIO was removed as a vendored file and in Pillow 4.0.0 (2017-01) in favour ofthe upstream olefile Python package, and replaced with an ImportError in 5.0.0(2018-01). The deprecated file has now been removed from Pillow. If needed, install fromPyPI (eg. python3 -m pip install olefile).