Google Subscriptions and Backwards Compatibility

RevenueCat compatibility with Google May 2022 Subscription Changes

In May 2022, Google introduced several new features for subscription products. These features are not supported in old versions of the RevenueCat SDK (see table below). To ensure that apps using previous versions of the SDKs remain operational, you have to set up products as “backwards compatible” in Google Play Console. If you use RevenueCat Offerings, RevenueCat allows setting up a backwards compatible fallback product that will only be used for apps using old versions of the SDK.


Private beta for Android SDK v6

Support for Google's May 2022 subscription changes in RevenueCat using the purchases-android SDK v6 is currently in private beta. If you are interested, please get in touch via our community.

Migration of existing products to SDK v6+

In order to support the new Google Play features through the RevenueCat Android SDK v6+ and above, any existing products set up in your app were automatically migrated. This step does not impact compatibility with previous versions of the SDK. Old SDK versions will continue to work as before, regardless of whether or not the migration was successful.

In some cases, the migration might have failed. This could be due to invalid Play Store service credentials, a product identifier being mistyped in RevenueCat, or the product having been deleted in Google Play Console in the meantime. In these cases, a warning will be displayed in the products page and when attempting to attach such a product to an Offering:


Since we are lacking required data to purchase this product in the RevenueCat Android SDK v6+, it will not work with this version of the SDK. In addition, products that couldn't be migrated prevent the creation or import of new products with the same identifier to prevent conflicts.

To fix this problem, you can try one of the following:

  • Delete the product in RevenueCat side and re-create or import it.
  • Update your Play Store service credentials in the app's settings in RevenueCat. This will re-trigger the migration. Please allow a few minutes for the migration to complete, and then check the product status again.
  • Create a new product with a new identifier.

If neither of these helps, please contact our support team.

RevenueCat SDK version support

The following table shows which SDK versions require backwards compatible products and which versions support all Google Play products:

RevenueCat SDKVersion requiring backwards compatible productVersions supporting all products
purchases-androidv5 and belowv6 and above (private beta)
purchases-react-nativev5 and belownot yet supported
purchases-flutterv4 and belownot yet supported
purchases-unityv4 and belownot yet supported
cordova-plugin-purchasesv3 and belownot yet supported