NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #528 most downloaded on pub.dev
Flutter in-app purchases and subscriptions made easy. The plugin supports iOS, macOS and Android.
Latest stable
11.0.1
Last release 13 days ago
05 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
303 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.16.2 (#1252) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.16.0 (#1250) via RevenueCat Git Bot (@RCGitBot)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Updates purchases-hybrid-common to 13.15.2 (#1244) via RevenueCat Git Bot (@RCGitBot)
Updates purchases-hybrid-common to 13.15.1 (#1241) via RevenueCat Git Bot (@RCGitBot)
try {
offerings = await Purchases.getOfferings();
} on PlatformException catch (e) {
final storeError = e.details['storeError'];
// Do something with storeError if it exists
}
Support Web Redemption Links (#1227) via Toni Rico (@tonidero)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.13.0 (#1226) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.12.1 (#1222) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.12.0 (#1215) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.9.0 (#1206) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.8.0 (#1201) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.7.0 (#1196) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.5.1 (#1182) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.5.0 (#1180) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.4.0 (#1174) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.3.0 (#1171) via RevenueCat Git Bot (@RCGitBot)
Update allowSharingAppStoreAccount Deprecation Message (#1163) via Will Taylor (@fire-at-will)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 13.2.0 (#1157) via RevenueCat Git Bot (@RCGitBot)
> When upgrading to v8, you must configure your In-App Purchase Key in the RevenueCat dashboard. Purchases on iOS will fail if the key is not configur
[!CAUTION] When upgrading to v8, you must configure your In-App Purchase Key in the RevenueCat dashboard. Purchases on iOS will fail if the key is not configured.
> When upgrading to v8, you must configure your In-App Purchase Key in the RevenueCat dashboard. Purchases on iOS will fail if the key is not configur
[!CAUTION] When upgrading to v8, you must configure your In-App Purchase Key in the RevenueCat dashboard. Purchases on iOS will fail if the key is not configured.
If you're using embedding v1, please check how to migrate in the official flutter docs.
Parse recordPurchase response (#1138) via Will Taylor (@fire-at-will)
Update fastlane-plugin-revenuecat_internal (#1133) via Mark Villacampa (@MarkVillacampa)
Version 7.0 of the SDK deprecates the term "Observer Mode" (and the APIs where this term was used), and replaces it with PurchasesAreCompletedBy (eith…
[!CAUTION] When upgrading to v7, you must configure your In-App Purchase Key in the RevenueCat dashboard. Purchases on iOS will fail if the key is not configured.
This latest release updates the Android SDK dependency from v7 to v8 to use BillingClient 7 and updates the iOS SDK dependency from v4 to v5 to use StoreKit 2 by default in the SDK.
This release raises the minumum required OS versions to the following:
In order to use StoreKit 2, you must configure your In-App Purchase Key in the RevenueCat dashboard. You can find instructions describing how to do this here.
usesStoreKit2IfAvailable is now storeKitVersionWhen configuring the SDK, the usesStoreKit2IfAvailable parameter has been replaced by an optional storeKitVersion: STOREKIT_VERSION parameter. It defaults to letting the iOS SDK determine the most appropriate version of StoreKit at runtime. If you'd like to use a specific version of StoreKit, you may provide a value for storeKitVersion like so:
PurchasesConfiguration configuration = PurchasesConfiguration("myAPIKey");
configuration.storeKitVersion = StoreKitVersion.storeKit1;
Purchases.configure(configuration);
Version 7.0 of the SDK deprecates the term "Observer Mode" (and the APIs where this term was used), and replaces it with PurchasesAreCompletedBy (either RevenueCat or your app). When specifying that your app will complete purchases, you must provide the StoreKit version that your app is using to make purchases on iOS. If your app is only available on Android, you may provide any value since the native Android SDK ignores this value.
You can enable it when configuring the SDK:
PurchasesConfiguration configuration = PurchasesConfiguration("myAPIKey");
configuration.purchasesAreCompletedBy = PurchasesAreCompletedByMyApp(
storeKitVersion: StoreKitVersion.storeKit2,
);
Purchases.configure(configuration);
By default, when purchases are completed by your app using StoreKit 2 on macOS, the SDK does not detect a user's purchase until after the user foregrounds the app after the purchase has been made. If you'd like RevenueCat to immediately detect the user's purchase, call Purchases.recordPurchase(productID) for any new purchases, like so:
await Purchases.recordPurchase(productID);
If purchases are completed by your app using StoreKit 1, you will need to explicitly configure the SDK to use StoreKit 1:
PurchasesConfiguration configuration = PurchasesConfiguration("myAPIKey");
configuration.purchasesAreCompletedBy = PurchasesAreCompletedByMyApp(
storeKitVersion: StoreKitVersion.storeKit1,
);
Purchases.configure(configuration);
Full migration guide to V7: Flutter - V7 API Migration Guide
Future proofing: StoreKit 1 APIs are being progressively deprecated by Apple, and new features are being added to StoreKit 2.
We have opened a channel in our Discord server for participants in the Beta to ask questions and give feedback: https://discord.gg/wXEfBGem5n.
Version 7.0 of the RevenueCat SDK enables full StoreKit 2 flow on the SDK and the RevenueCat backend by default.
We have been testing StoreKit 2 support in parallel to StoreKit 1 in our backend for a while and we believe it is ready for widespread use.
Here's some of the benefits you get with StoreKit 2:
In order to use StoreKit 2, you will need to configure your In-App Purchase Key in the RevenueCat dashboard.
The previously deprecated configuration option usesStoreKit2IfAvailable has been removed. Remove it from your configuration option to continue using StoreKit 2.
The SDK will automatically use StoreKit 1 where StoreKit 2 is not supported, in iOS 14 and earlier.
If for any reason you need to always use StoreKit 1, it is possible to switch back using the following configuration API:
await Purchases.configure(
PurchasesConfiguration('api_key')
..storeKitVersion = StoreKitVersion.storeKit1,
);
If you are using any 3rd party analytics SDKs to automatically track in-app purchases, you need to be aware most of them do not completely support logging purchases made with StoreKit 2. This is the case for some popular SDKs like Facebook, Mixpanel, OneSignal, Segment or Firebase. For these services, we recommend you use our data integrations.
If you're using the Firebase SDK, you'll need to follow these instructions to log purchases made with StoreKit 2.
Version 7.0 of the SDK introduces support for observer mode when making purchases with StoreKit 2. You can enable it when configuring the SDK:
await Purchases.configure(
PurchasesConfiguration('api_key')
..storeKitVersion = StoreKitVersion.storeKit2,
..observerMode = true,
);
Additionally, because of the way in which StoreKit 2 operates, you must manually handle newly purchased transactions by calling Purchases.handleObserverModeTransaction(). Subscription updates will be automatically tracked.
# Your existing code to purchase a product with ID "product_id"
await purchaseProduct("product_id")
# Inform the SDK about the new purchase
await Purchases.handleObserverModeTransaction("product_id");
If you're using observer mode with StoreKit 1, you will need to explicitly configure the SDK to use StoreKit 1:
await Purchases.configure(
PurchasesConfiguration('api_key')
..storeKitVersion = StoreKitVersion.storeKit1,
..observerMode = true,
);
If you're converting a paid app to in-app subscriptions, and want to provide existing customers with certain features, we recommend using the "original app version" field in customer info.
Because of a limitation of StoreKit 2, this field is not available. If this is a requirement for you, we recommend switching back to StoreKit 1.
The minimum target has been raised to iOS 13.0 and macOS 10.15.
Fix syncObserverModeAmazonPurchase deprecation warning (#1115) via Toni Rico (@tonidero)
syncObserverModeAmazonPurchase deprecation warning (#1115) via Toni Rico (@tonidero)Add OptIn annotation on paywalls code (#1112) via Cesar de la Vega (@vegaro)
OptIn annotation on paywalls code (#1112) via Cesar de la Vega (@vegaro)Add support for DEFERRED upgrades and updates purchases-hybrid-common to 11.1.0 (#1108) via RevenueCat Git Bot (@RCGitBot)
DEFERRED upgrades and updates purchases-hybrid-common to 11.1.0 (#1108) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.9.0 (#1096) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.8.0 (#1091) via RevenueCat Git Bot (@RCGitBot)
Fix purchaseDiscountedPackage (#1080) via Toni Rico (@tonidero)
purchaseDiscountedPackage (#1080) via Toni Rico (@tonidero)[EXTERNAL] fix: call presentPaywallIfNeeded when needed (#1066) by @danjocha (#1069) via Cesar de la Vega (@vegaro)
Crash on Amazon paywalls after purchasing (#1053) via Cesar de la Vega (@vegaro)
trigger_bump lane (#1058) via Cesar de la Vega (@vegaro)[AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.5.0 (#1051) via RevenueCat Git Bot (@RCGitBot)
Fix touches passing through paywall when using presentPaywall methods (#1044) via Toni Rico (@tonidero)
externalStore to Store enum (#1043) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.4.0 (#1037) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 10.3.2 (#1031) via RevenueCat Git Bot (@RCGitBot)
Add onDismiss handler and displayCloseButton to PaywallView and PaywallFooterView (#1009) via Toni Rico (@tonidero)
onDismiss handler and displayCloseButton to PaywallView and PaywallFooterView (#1009) via Toni Rico (@tonidero)PaywallFooterView listeners (#1012) via Toni Rico (@tonidero)PaywallView listeners (#995) via Cesar de la Vega (@vegaro)PaywallFooterView support (#996) via Toni Rico (@tonidero)
PaywallFooterView support (#996) via Toni Rico (@tonidero)Make CustomerInfo allPurchaseDates values nullable (#989) via Toni Rico (@tonidero)
CustomerInfo allPurchaseDates values nullable (#989) via Toni Rico (@tonidero)[AUTOMATIC BUMP] Updates purchases-hybrid-common to 9.7.2 (#984) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 9.7.1 (#978) via RevenueCat Git Bot (@RCGitBot)
[EXTERNAL] Adds productPlanIdentifier parameter to EntitlementInfo (#910) via @splangi (#960) via Cesar de la Vega (@vegaro)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 9.3.0 (#958) via RevenueCat Git Bot (@RCGitBot)
Paywalls: displayCloseButton parameter (#948) via NachoSoto (@NachoSoto)
Paywalls: displayCloseButton parameter (#948) via NachoSoto (@NachoSoto)Paywalls: added Offering parameter to presentPaywall methods (#947) via NachoSoto (@NachoSoto)Paywalls: separate PurchasesHybridCommonUI (#943) via NachoSoto (@NachoSoto)
Paywalls: separate PurchasesHybridCommonUI (#943) via NachoSoto (@NachoSoto)Updates purchases-hybrid-common to 8.11.1 (#940) via RevenueCat Git Bot (@RCGitBot)
Updates purchases-hybrid-common to 8.11.0 (#937) via RevenueCat Git Bot (@RCGitBot)
📱 Initial support for cross-platform RevenueCat Paywalls 🐾 🧱
MainActivity to subclass FlutterFragmentActivity instead of FlutterActivity. Also, the min sdk version of the new package is 24. Please make sure your app's android/build.gradle minSdkVersion has that or a higher version.purchases-ui-flutter in your pubspec.yaml:dependencies:
purchases_ui_flutter: 6.15.0
import 'package:purchases_ui_flutter/purchases_ui_flutter.dart';
await RevenueCatUI.presentPaywallIfNeeded("pro");
addCustomerInfoUpdateListener📱 Initial support for cross-platform RevenueCat Paywalls 🐾 🧱
MainActivity to subclass FlutterFragmentActivity instead of FlutterActivity. Also, the min sdk version of the new package is 24. Please make sure your app's android/build.gradle minSdkVersion has that or a higher version.purchases-ui-flutter in your pubspec.yaml:dependencies:
purchases_ui_flutter: 6.15.0-beta.4
import 'package:purchases_ui_flutter/purchases_ui_flutter.dart';
await RevenueCatUI.presentPaywallIfNeeded("pro");
addCustomerInfoUpdateListenerpurchases_flutter.import 'package:purchases_ui_flutter/purchases_ui_flutter.dart';Purchases.presentPaywall to RevenueCatUI.presentPaywall.presentPaywall and presentPaywallIfNeeded now don't return a result. To detect purchases, please use Purchases.getCustomerInfo from the purchases_flutter SDK. A return value will be added in future releases.purchases-ui-flutter (#924) via Toni Rico (@tonidero)paywalls to latest main (#923) via Toni Rico (@tonidero)purchases_flutter_ui to purchases_ui_flutter (#921) via Toni Rico (@tonidero)[AUTOMATIC BUMP] Updates purchases-hybrid-common to 8.2.1 (#912) via RevenueCat Git Bot (@RCGitBot)
Fix flutter analyze deprecation warnings
MainActivity to subclass FlutterFragmentActivity instead of FlutterActivity.purchases-flutter in your pubspec.yaml:dependencies:
purchases_flutter: 6.6.0-beta.3
await Purchases.presentPaywallIfNeeded("pro");
addCustomerInfoUpdateListenerminSdkVersion is temporarily increased from 19 to 24 to support paywalls. This will be reverted in a future release as we split purchases_flutter and purchases_flutter_uiPurchasesFlutterActivity has been removed. Use FlutterFragmentActivity provided by Flutter insteadpresentPaywallIfNeeded (#904) via Toni Rico (@tonidero)[AUTOMATIC BUMP] Updates purchases-hybrid-common to 8.1.1 (#892) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 8.1.0 (#890) via RevenueCat Git Bot (@RCGitBot)
Fix flutter analyze deprecation warnings (#872) via Toni Rico (@tonidero)
Trusted Entitlements: add support for setting EntitlementVerificationMode and getting verification result in EntitlementInfos and EntitlementInfo (#753) via NachoSoto (@NachoSoto)CI: disable prepare-next-version (#869) via NachoSoto (@NachoSoto)[AUTOMATIC BUMP] Updates purchases-hybrid-common to 7.3.3 (#864) via RevenueCat Git Bot (@RCGitBot)
Purchase Tester: remove unused Activity (#860) via NachoSoto (@NachoSoto).common_version (#861) via NachoSoto (@NachoSoto)3.10.1 to VERSIONS (#858) via NachoSoto (@NachoSoto)📱 Initial support for cross-platform RevenueCat Paywalls 🐾 🧱
purchases-flutter in your pubspec.yaml:dependencies:
purchases_flutter: 6.3.0-beta.2
MainActivity to subclass PurchasesFlutterActivity instead of FlutterActivity.await Purchases.presentPaywallIfNeeded("pro");
addCustomerInfoUpdateListenerminSdkVersion is temporarily increased from 19 to 24 to support paywalls. This will be reverted in a future release as we split purchases_flutter and purchases_flutter_ui📱 Initial support for cross-platform RevenueCat Paywalls 🐾 🧱
purchases-flutter in your pubspec.yaml:dependencies:
purchases_flutter: 6.3.0-beta.1
MainActivity to subclass PurchasesFlutterActivity instead of FlutterActivity.await Purchases.presentPaywallIfNeeded("pro");
addCustomerInfoUpdateListenerminSdkVersion is temporarily increased from 19 to 24 to support paywalls. This will be reverted in a future release as we split purchases_flutter and purchases_flutter_ui[AUTOMATIC BUMP] Updates purchases-hybrid-common to 7.2.0 (#844) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 7.1.0 (#835) via RevenueCat Git Bot (@RCGitBot)
RevenueCat Flutter SDK v6 is here!! 😻
RevenueCat Flutter SDK v6 is here!! 😻
This latest release updates the SDK to use BillingClient 6 in Android. This version of BillingClient brings little change compared with BillingClient 5 which brought an entire new subscription model which resulted in large changes across the entire SDK.
The only modification at the API level involves replacing "ProrationMode" with "ReplacementMode". The specific replacement modes remain unchanged.
If your app doesn't currently use DEFERRED replacement modes, then you should be safe to upgrade to this version without changes in behavior.
If your app supports product changes using DEFERRED replacement mode, then you can either stick with the previous major version until support for DEFERRED is re-introduced in this major version, or you can remove DEFERRED replacement options from your app.
If you are using the SDK in observer mode, you should only use v6 in Android if you're using BillingClient 6.
See the Android Native - 6.x to 7.x Migration for more details.
If you come from an older version of the RevenueCat SDK, see Android Native - 5.x to 6.x Migration for a more thorough explanation of the new Google subscription model announced with BillingClient 5 and how to take advantage of it.
RevenueCat SDK v7 bumps minimum Android SDK version from Android 4.0 (API level 16) to Android 4.4 (API level 19).
We've added new APIs to support InApp messages both in Android and iOS. You can read more about:
InApp Messages are shown by default in both platforms. If you want to disable this behaviour during configuration of the RevenueCat SDK, setup the shouldShowInAppMessagesAutomatically property during configuration to false:
PurchasesConfiguration configuration = PurchasesConfiguration("api_key");
configuration.shouldShowInAppMessagesAutomatically = false;
Purchases.configure(configuration);
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 6.3.2 (#1008) via RevenueCat Git Bot (@RCGitBot)
One column per quarter.