Skip to content

Google Play policy issueGoogle Play Console warning: your app uses an unsupported Google Play Billing Library version

Play Console shows a policy warning that your app uses an unsupported Google Play Billing Library version, and an update you upload is blocked. Every Billing Library version is supported for two years. Once its deadline passes, new apps and updates must ship a newer one, so an app that has not touched its billing code in a while gets stuck.

Short answer

Find the billing dependency in your Android build (com.android.billingclient:billing, or the version pulled in by a plugin such as in_app_purchase or RevenueCat), and move it to version 8 or later. Version 9 is the newest in Google’s table, and its migration guide is linked below. Build, upload, and check that the warning clears. If you already upgraded and the warning stays, check that the merged AndroidManifest.xml contains com.google.android.play.billingclient.version.

Why the update is blocked, and the fix

  1. 01

    The billing library in the app is past its deadline

    “Reminder: By Aug 31, 2026, all new apps and updates to existing apps must use Billing Library version 8 or later.” Google, Google Play Billing Library deprecation FAQ

    Google retires each Billing Library version on a fixed schedule. As of November 2026, Google’s table lists version 7 with a new app and update deadline of August 31, 2026 and an extension deadline of November 1, 2026, so version 8 is now the minimum. Check the table on Google’s page for the current dates before you plan the work.

  2. 02

    Upgrade the dependency, not just the number

    “All versions of the Google Play Billing Library have a two-year deprecation cycle.” Google, Google Play Billing Library deprecation FAQ

    Raising the version in build.gradle is the start. New major versions remove old methods, so the purchase flow, the query calls and the acknowledgement code may need changes. Follow Google’s migration guide for the version you move to, then test a real purchase with a license tester before you release.

    // app/build.gradle: use version 8 or later; take the current release from Google’s release notes
    dependencies {
        implementation "com.android.billingclient:billing:$billing_version"
    }
    
    // see which billing version actually ships
    ./gradlew app:dependencies | grep billing
  3. 03

    A plugin or SDK brings its own old version

    “Make sure your AndroidManifest.xml file contains com.google.android.play.billingclient.version.” Google, Google Play Billing Library deprecation FAQ

    In Flutter, React Native and other cross-platform apps the billing library usually comes from a package: in_app_purchase, react-native-iap, RevenueCat and others. Update that package to a release built on a supported Billing Library version, then run ./gradlew app:dependencies | grep billing, or check the merged manifest, to see which version actually ships.

  4. 04

    Old builds still work, new uploads do not

    “Unmaintained APKs don't need updates; existing apps still work, but new apps and updates must use supported versions.” Google, Google Play Billing Library deprecation FAQ

    The deadline only blocks new apps and updates. Users with the current version keep it, and their purchases keep working. The problem shows up the day you need to ship a fix, so plan the upgrade before the next release, not during it.

Checked against the vendor’s docs on : Android Developers: Google Play Billing Library deprecation FAQ (deadline table); Android Developers: Migrate to Google Play Billing Library 9.

Rather hand it over?

Fixed scope, fixed price, paid upfront. The work happens in writing; no call needed.

Related: Google Play target API level requirement · RevenueCat products could not be fetched · Google Play version code already used · App Bundle signed with the wrong key

Questions

More on this launch

Can I get more time?

Google offers an extension form on the warning’s details page under Policy status, up to the extension deadline in its table. Check the table for your version’s extension date; for version 7 it was November 1, 2026.

I upgraded but the warning is still there. Why?

Google’s FAQ says to check that AndroidManifest.xml contains com.google.android.play.billingclient.version. If a plugin still pins an old library, the merged manifest shows the old version. Update the plugin and upload again.

Can you fix it for me?

If one bug is the whole problem, the App Fix Ticket covers it: a written diagnosis first, then the fix. If the app has more going on, the Launch Check is a written check of the whole app. Each issue found is rated critical, high, medium or low, with where it is and how it was confirmed. No issues worth fixing, no charge. If the Launch Check finds nothing rated medium or higher, Simon refunds the full $450. You keep the report either way. This applies to the first 10 Launch Checks bought after October 30, 2026.

Something else?

Describe it and get a written quote

Describe the app and where it is in the launch. You get a written scope, a fixed price and a timeline; Simon replies by email, usually within one business day.