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

This release brings full support for Bot API 8.2 and includes a bug fix for the deserialization of Gift and Gifts.
Moreover, with the update of the optional apscheduler dependency used for the JobQueue, we have deprecated support for pytz timezones.
Please switch to using zoneinfo.ZoneInfo timezones after upgrading.

For the full list of changes and improvements, please see the below changelog.

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)

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

This release brings full support for Bot API 8.3. It also removes functionality deprecated in Bot API 8.2 and 7.4. This is in line with our stability policy.
The extended customization support for Bot.base_(file_)url makes it possible to use use Telegrams testing environment with PTB. Moreover, the built-in AIORateLimiter now respects the allow_paid_broadcast parameter.

For the full list of changes and improvements, please see the below changelog.

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)

We've just released v21.11.1.
As usual, upgrade using pip install -U python-telegram-bot.

This is a bug fix release that restores the documentation at https://docs.python-telegram-bot.org.

Documentation Improvements

• Fix ReadTheDocs Build (#4695)

We are happy to announce that ptbtest has found a new maintainer in @AlexPHorta. We wish them the best of luck with their new project!

https://t.me/pythontelegrambotchannel/115

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.

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.