---
id: types-pillow
version: "10.2.0.20240822"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-Pillow — Typing stubs for Pillow

License: permissive · Maintenance: active · Downloads: 4.2M/mo

## What it is and what it does

types-Pillow is a PEP 561 type stub package that provides type annotations for Pillow 10.2.*, allowing static type checkers to understand and validate code that uses Pillow's image processing functions. It has no runtime dependencies and is installed alongside your type checker to improve code quality during development.

The stubs are maintained in the typeshed repository and are tested against mypy 1.11.1, pyright 1.1.377, and pytype 2024.4.11. However, this package is now superseded: Pillow itself has included native type annotations since version 10.3.0, so you should uninstall types-Pillow if you upgrade to Pillow 10.3.0 or later.

Use it for:

- Enable type checkers to validate image processing code that imports Pillow without runtime overhead.
- Catch type errors in Pillow API calls during development before they reach production.
- Integrate Pillow type checking into a CI/CD pipeline using a static type checker.
- Use in an IDE to get inline type hints and autocomplete for Pillow functions.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for Pillow, enabling static type checkers to validate code using Pillow's image processing library.

Yes, if you are using Pillow 10.2.* and want static type checking. Install it alongside your type checker. However, if you are already on Pillow 10.3.0 or later, uninstall this package—Pillow now provides its own type annotations and this stub becomes redundant. No security vulnerabilities are known.

## Install

pip install types-pillow
uv add types-pillow
poetry add types-pillow

## Installing types-Pillow

Before you install: Low install friction with no runtime dependencies. Actively maintained and tested with current type checker versions. Note: Pillow itself includes type annotations since version 10.3.0, making this package redundant for newer Pillow versions.

License in practice: Apache-2.0 is permissive and places no restrictions on use, modification, or distribution in your own projects.

Quickstart:

pip install types-Pillow

# Use with your type checker on code that imports Pillow
# Type checker will now understand Pillow's API

Requires Python >=3.8. Only useful if you are running a static type checker; does not affect runtime.

Verify before relying:

- Whether type coverage is complete for all Pillow 10.2.* APIs or if some areas remain untyped.
- Compatibility with Pillow versions outside the 10.2.* range that this stub targets.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pillow type stubs, type checking pillow, pillow type hints, pep 561 stubs, static type checking images, pillow annotations, type-stubs, static-analysis

[View on SkillFed](https://skillfed.io/packages/types-pillow) · [View on PyPI](https://pypi.org/project/types-pillow/)