Google Play Billing Library version deprecation

As announced at Google I/O in 2019 and the Meet Google Play Billing Library Version 3 blog post, all versions of Play Billing Library will follow a two year deprecation cycle.

This topic answers common questions regarding Billing Library version deprecation and migrating to newer versions.

Support timeline For different versions

Version (including minor versions) Last date version can be used to release new apps Last date version can be used to release updates to existing apps
4 Aug-1-2023 Nov-1-2023
5 Aug-1-2024 Nov-1-2024
6 Aug-1-2025 Nov-1-2025
How can I find which APK or App Bundle is triggering a deprecation warning?
Review your project's imported dependencies (for example, those found in your project's build.gradle file). To be compliant, apps must import version 5.0.0 or higher of the Play Billing Library. Note that Billing dependencies would be found only in APKs that require the com.android.vending.BILLING permission.
An APK or App Bundle that I no longer maintain is using a deprecated version of the Play Billing Library. Do I need to update?
We strongly recommend updating all APKs to the latest version of the Play Billing Library. However, if an APK is no longer maintained, then no action is required for the APK at this time. This deprecation prevents only new apps and updates from using older versions of the Play Billing Library. Existing apps that use a deprecated version of the library will continue to function as expected. Please ensure that all actively maintained APKs are updated.
How to fix APK or App Bundle updated to latest Play Billing Library but still triggering deprecation warning?
Make sure your AndroidManifest.xml contains an entry with name com.google.android.play.billingclient.version. If the entry isn't present, check your manifest merge settings to see if the manifest attribute is being dropped during manifest merging.
How can I upgrade from an earlier version of Play Billing Library?

Update the dependency in your release to use v5 or higher of the Play Billing Library. To see what changed between releases, read the release notes.

In addition, we have an in-depth guide for migrating from PBL 4 to 5.