# What changed in python-telegram-bot

> 30 changes in python-telegram-bot 11 to 12 from its official release notes, upgrade guides and advisories: 4 breaking, 2 deprecations, 15 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/pypi/python-telegram-bot/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## python-telegram-bot 12

### Breaking changes

- Callbacks are context based in version 12, changing how developers write callbacks. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)
- from_timestamp() now returns UTC. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)
- Python 3.4 is no longer supported. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)

### Deprecations

- Arguments including edited_messages and channel_post are deprecated as part of the filter overhaul. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)
- RegexHandler is deprecated as part of the filter overhaul. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)

### New APIs and options

- PrefixHandler was added as part of the handler overhaul. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)

### Behavior and default changes

- The Error Handler now handles all types of exceptions. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)
- Persistence is listed as a major change in version 12. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)

### Fixes and other changes

- Support was added for Bot API 4.1, 4.2, and 4.3. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)
- ConversationHandler has various changes and fixes in this release. (12.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v12.0.0)

## python-telegram-bot 11

### Breaking changes

- Passport decryption requires the cryptography dependency. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)

### New APIs and options

- Adds width, height, and duration to Animation. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds a thumb field to Audio, Video and Videonote. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds Bot.edit_message_media and the InputMediaAnimation, InputMediaAudio, and inputMediaDocument types. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds Bot.send_animation, Animation width, height, and duration fields, and Filters.animation. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds support for the CASHTAG message entity. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds a filter for messages containing Passport data. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds forusquare_type to Venue, InlineQueryResultVenue, InputVenueMessageContent, and Bot.send_venue. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds the passport_data field to Message. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds Telegram Passport support types, including PassportData, PassportFile, EncryptedPassportElement, EncryptedCredentials, and PassportElementError variants. PassportData can be decrypted, and PassportFiles originating from decrypted PassportData are automatically decrypted. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds support for the PHONE_NUMBER message entity. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds a bot method for setting Telegram Passport data errors. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds t.me links for User, Chat and Message when available, and updates User.mention_*. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds the thumb= argument to send_ methods to specify thumbnails for photos and videos. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Adds vCard support through a vcard field on Contact, InlineQueryResultContact, InputContactMessageContent, and Bot.send_contact. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)

### Fixes and other changes

- Can now send more than one media item. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Fixes Filters.regex failing on non-text messages. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Includes a minor integer comparison fix. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Fixes mention_markdown/html on Python 2. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)
- Fixes ProcessLookupError when a process finishes before it is killed. (11.0.0) — [release notes](https://github.com/python-telegram-bot/python-telegram-bot/releases/tag/v11.0.0)