We've just released v22.5.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.

The release notes can be found here.

We've just released v22.4.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.

The release notes can be found here.

We've just released v22.3.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.

The release notes can be found here.

We've just released v22.2.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.

The release notes can be found here.

We've just released v22.1.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.

The release notes can be found here.

We've just released v22.0.
Thank you to everyone who contributed to this release.
As usual, upgrade using pip install -U python-telegram-bot.

The release notes can be found here.

Version 21.11.1

Released 2025-03-01

This is the technical changelog for version 21.11.1. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Documentation Improvements

• Fix ReadTheDocs Build (#4695)

Version 21.11

Released 2025-03-01

This is the technical changelog for version 21.11. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Major Changes and New Features

• Full Support for Bot API 8.3 (#4676 closes #4677, #4682 by @aelkheir, #4690 by @aelkheir, #4691 by @aelkheir)
• Make provider_token Argument Optional (#4689)
• Remove Deprecated InlineQueryResultArticle.hide_url (#4640 closes #4638)
• Accept datetime.timedelta Input in Bot Method Parameters (#4651)
• Extend Customization Support for Bot.base_(file_)url (#4632 closes #3355)
• Support allow_paid_broadcast in AIORateLimiter (#4627 closes #4578)
• Add BaseUpdateProcessor.current_concurrent_updates (#4626 closes #3984)

Minor Changes and Bug Fixes

• Add Bootstrapping Logic to Application.run_* (#4673 closes #4657)
• Fix a Bug in edit_user_star_subscription (#4681 by @vavasik800)
• Simplify Handling of Empty Data in TelegramObject.de_json and Friends (#4617 closes #4614)

Documentation Improvements

• Documentation Improvements (#4641)
• Overhaul Admonition Insertion in Documentation (#4462 closes #4414)

Internal Changes

• Stabilize Linkcheck Test (#4693)
• Bump pre-commit Hooks to Latest Versions (#4643)
• Refactor Tests for TelegramObject Classes with Subclasses (#4654 closes #4652)
• Use Fine Grained Permissions for GitHub Actions Workflows (#4668)

Dependency Updates

• Bump actions/setup-python from 5.3.0 to 5.4.0 (#4665)
• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 (#4666)
• Bump actions/stale from 9.0.0 to 9.1.0 (#4667)
• Bump astral-sh/setup-uv from 5.1.0 to 5.2.2 (#4664)
• Bump codecov/test-results-action from 1.0.1 to 1.0.2 (#4663)

Version 21.10

Released 2025-01-03

This is the technical changelog for version 21.10. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Major Changes

• Full Support for Bot API 8.2 (#4633)
• Bump apscheduler & Deprecate pytz Support (#4582)

New Features

• Add Parameter pattern to JobQueue.jobs() (#4613 closes #4544)
• Allow Input of Type Sticker for Several Methods (#4616 closes #4580)

Bug Fixes

• Ensure Forward Compatibility of Gift and Gifts (#4634 closes #4637)

Documentation Improvements & Internal Changes

• Use Custom Labels for dependabot PRs (#4621)
• Remove Redundant pylint Suppressions (#4628)
• Update Copyright to 2025 (#4631)
• Refactor Module Structure and Tests for Star Payments Classes (#4615 closes #4593)
• Unify datetime Imports (#4605 by @cuevasrja closes #4577)
• Add Static Security Analysis of GitHub Actions Workflows (#4606)

Dependency Updates

• Bump astral-sh/setup-uv from 4.2.0 to 5.1.0 (#4625)
• Bump codecov/codecov-action from 5.1.1 to 5.1.2 (#4622)
• Bump actions/upload-artifact from 4.4.3 to 4.5.0 (#4623)
• Bump github/codeql-action from 3.27.9 to 3.28.0 (#4624)

Version 21.9

Released 2024-12-07

This is the technical changelog for version 21.9. More elaborate release notes can be found in the news channel @pythontelegrambotchannel.

Major Changes

• Full Support for Bot API 8.1 (#4594 closes #4592)

Minor Changes

• Use MessageLimit.DEEP_LINK_LENGTH in helpers.create_deep_linked_url (#4597 by @nemacysts)
• Allow Sequence Input for allowed_updates in Application and Updater Methods (#4589 by @nemacysts)

Dependency Updates

• Update aiolimiter requirement from ~=1.1.0 to >=1.1,<1.3 (#4595)
• Bump pytest from 8.3.3 to 8.3.4 (#4596)
• Bump codecov/codecov-action from 4 to 5 (#4585)
• Bump pylint to v3.3.2 to Improve Python 3.13 Support (#4590 by @nemacysts)
• Bump srvaroa/labeler from 1.11.1 to 1.12.0 (#4586)