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

The release notes can be foundhere.

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

The release notes can be foundhere.

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)
• Makeprovider_token Argument Optional (#4689)
• Remove DeprecatedInlineQueryResultArticle.hide_url (#4640 closes#4638)
• Acceptdatetime.timedelta Input inBot Method Parameters (#4651)
• Extend Customization Support forBot.base_(file_)url (#4632 closes#3355)
• Supportallow_paid_broadcast inAIORateLimiter (#4627 closes#4578)
• AddBaseUpdateProcessor.current_concurrent_updates (#4626 closes#3984)

Minor Changes and Bug Fixes

• Add Bootstrapping Logic toApplication.run_* (#4673 closes#4657)
• Fix a Bug inedit_user_star_subscription (#4681 by@vavasik800)
• Simplify Handling of Empty Data inTelegramObject.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)
• Bumppre-commit Hooks to Latest Versions (#4643)
• Refactor Tests forTelegramObject Classes with Subclasses (#4654 closes#4652)
• Use Fine Grained Permissions for GitHub Actions Workflows (#4668)

Dependency Updates

• Bumpactions/setup-python from 5.3.0 to 5.4.0 (#4665)
• Bumpdependabot/fetch-metadata from 2.2.0 to 2.3.0 (#4666)
• Bumpactions/stale from 9.0.0 to 9.1.0 (#4667)
• Bumpastral-sh/setup-uv from 5.1.0 to 5.2.2 (#4664)
• Bumpcodecov/test-results-action from 1.0.1 to 1.0.2 (#4663)

Contributors

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)
• Bumpapscheduler & Deprecatepytz Support (#4582)

New Features

• Add Parameterpattern toJobQueue.jobs() (#4613 closes#4544)
• Allow Input of TypeSticker for Several Methods (#4616 closes#4580)

Bug Fixes

• Ensure Forward Compatibility ofGift andGifts (#4634 closes#4637)

Documentation Improvements & Internal Changes

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

Dependency Updates

• Bumpastral-sh/setup-uv from 4.2.0 to 5.1.0 (#4625)
• Bumpcodecov/codecov-action from 5.1.1 to 5.1.2 (#4622)
• Bumpactions/upload-artifact from 4.4.3 to 4.5.0 (#4623)
• Bumpgithub/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

• UseMessageLimit.DEEP_LINK_LENGTH inhelpers.create_deep_linked_url (#4597 by@nemacysts)
• AllowSequence Input forallowed_updates inApplication andUpdater Methods (#4589 by@nemacysts)

Dependency Updates

• Updateaiolimiter requirement from ~=1.1.0 to >=1.1,<1.3 (#4595)
• Bumppytest from 8.3.3 to 8.3.4 (#4596)
• Bumpcodecov/codecov-action from 4 to 5 (#4585)
• Bumppylint to v3.3.2 to Improve Python 3.13 Support (#4590 by@nemacysts)
• Bumpsrvaroa/labeler from 1.11.1 to 1.12.0 (#4586)

Contributors

Version 21.8

Released 2024-12-01

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

Major Changes

• Full Support for Bot API 8.0 (#4568,#4566 closes#4567,#4572,#4571,#4570,#4576,#4574)

Documentation Improvements

• Documentation Improvements (#4565 by@Snehashish06,#4573)

Version 21.7

Released 2024-11-04

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

Major Changes

• Full Support for Bot API 7.11 (#4546 closes#4543)
• AddMessage.reply_paid_media (#4551)
• Drop Support for Python 3.8 (#4398 by@elpekenin)

Minor Changes

• AllowSequence inApplication.add_handlers (#4531 by@roast-lord closes#4530)
• Improve Exception Handling inFile.download_* (#4542)
• Use Stable Python 3.13 Release in Test Suite (#4535)

Documentation Improvements

• Documentation Improvements (#4536 by@Ecode2,#4556)
• Fix Linkcheck Workflow (#4545)
• Usesphinx-build-compatibility to Keep Sphinx Compatibility (#4492)

Internal Changes

• Improve Test Instability Caused byMessage Fixtures (#4507)
• Stabilize Some Flaky Tests (#4500)
• Reduce Creation of HTTP Clients in Tests (#4493)
• Updatepytest-xdist Usage (#4491)
• Fix Failing Tests by Making Them Independent (#4494)
• Introduce Codecov's Test Analysis (#4487)
• Maintenance Work onBot Tests (#4489)
• Introduceconftest.py for File Related Tests (#4488)
• Update Issue Templates to Use Issue Types (#4553)
• Update Automation to Label Changes (#4552)

Dependency Updates

• Bumpsrvaroa/labeler from 1.11.0 to 1.11.1 (#4549)
• Bumpsphinx from 8.0.2 to 8.1.3 (#4532)
• Bumpsphinxcontrib-mermaid from 0.9.2 to 1.0.0 (#4529)
• Bumpsrvaroa/labeler from 1.10.1 to 1.11.0 (#4509)
• BumpBibo-Joshi/pyright-type-completeness from 1.0.0 to 1.0.1 (#4510)

Contributors

Version 21.6

Released 2024-09-19

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

New Features

• Full Support for Bot API 7.10 (#4461 closes#4459,#4460,#4463 by aelkheir,#4464)
• Add Parameterhttpx_kwargs toHTTPXRequest (#4451 closes#4424)

Minor Changes

• Improve Type Completeness (#4466)

Internal Changes

• Update Python 3.13 Test Suite to RC2 (#4471)
• Enforce theoffline_bot Fixture inTest*WithoutRequest (#4465)
• Make Tests fortelegram.ext Independent of Networking (#4454)
• Rename Testing Base Classes (#4453)

Dependency Updates

• Bumppytest from 8.3.2 to 8.3.3 (#4475)

Version 21.5

Released 2024-09-01

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

Major Changes

• Full Support for Bot API 7.9 (#4429)
• Full Support for Bot API 7.8 (#4408)

New Features

• AddMessageEntity.shift_entities andMessageEntity.concatenate (#4376 closes#4372)
• Add Parametergame_pattern toCallbackQueryHandler (#4353 by@jainamoswal closes#4269)
• Add Parameterread_file_handle toInputFile (#4388 closes#4339)

Documentation Improvements

• Bugfix for "Available In" Admonitions (#4413)
• Documentation Improvements (#4400 closes#4446,#4448 by@Palaptin)
• Document Return Types ofRequestData Members (#4396)
• Add Introductory Paragraphs to Telegram Types Subsections (#4389 by@mohdyusuf2312 closes#4380)
• Start Adapting to RTD Addons (#4386)

Minor and Internal Changes

• Remove Surplus Logging fromUpdater Network Loop (#4432 by@MartinHjelmare)
• Add Internal Constants for Encodings (#4378 by@elpekenin)
• Improve PyPI Automation (#4375 closes#4373)
• Update Test Suite to New Test Channel Setup (#4435)
• Improve Fixture Usage intest_message.py (#4431 by@Palaptin)
• Update Python 3.13 Test Suite to RC1 (#4415)
• Bumpruff and Add New Rules (#4416)

Dependency Updates

• Updatecachetools requirement from <5.5.0,>=5.3.3 to >=5.3.3,<5.6.0 (#4437)
• Bumpsphinx from 7.4.7 to 8.0.2 andfuro from 2024.7.18 to 2024.8.6 (#4412)
• Bumptest-summary/action from 2.3 to 2.4 (#4410)
• Bumppytest from 8.2.2 to 8.3.2 (#4403)
• Bumpdependabot/fetch-metadata from 2.1.0 to 2.2.0 (#4411)
• Updatecachetools requirement from ~=5.3.3 to >=5.3.3,<5.5.0 (#4390)
• Bumpsphinx from 7.3.7 to 7.4.7 (#4395)
• Bumpfuro from 2024.5.6 to 2024.7.18 (#4392)

Contributors