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 16 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.
Bump PHC 6.3.1 (#965) via Toni Rico (@tonidero)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 6.3.0 (#823) via RevenueCat Git Bot (@RCGitBot)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 6.2.0 (#814) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 6.1.2 (#802) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 6.1.0 (#797) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.6.4 (#793) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.6.3 (#786) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.6.1 (#782) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.6.0 (#778) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.5.0 (#774) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.4.1 (#769) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.3.0 (#759) via RevenueCat Git Bot (@RCGitBot)
Adds package back to AndroidManifest.xml (#749) via Cesar de la Vega (@vegaro)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.2.3 (#744) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.2.2 (#740) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.2.0 (#735) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 5.1.0 (#730) via RevenueCat Git Bot (@RCGitBot)
RevenueCat Purchases Flutter v5 is here!! 😻
RevenueCat Purchases Flutter v5 is here!! 😻
This latest release updates the Android SDK dependency from v5 to v6 to use BillingClient 5. This version of BillingClient brings an entire new subscription model which has resulted in large changes across the entire SDK.
SubscriptionOption conceptIn v4, a Google Play Android Package or StoreProduct represented a single purchaseable entity, and free trials or intro
offers would automatically be applied to the purchase if the user was eligible.
Now, in Flutter v5, an Google Play Android Package or StoreProduct represents a duration of a subscription and contains all the ways to purchase that duration -- any offers and its base plan. Each of these purchase options are SubscriptionOptions.
When passing a Package to purchasePackage() or StoreProduct to purchaseStoreProduct(), the SDK will use the following logic to choose which
SubscriptionOption to purchase:
SubscriptionOption with the longest free trial or cheapest first phase
For more control, purchase subscription options with the new purchaseSubscriptionOption() method.
StoreProduct now has a few new properties use for Google Play Android:
defaultOption
Package or StoreProductsubscriptionOptions
Observer mode is still supported in v5. Other than updating the SDK version, there are no changes required.
✨ With this new feature, even if our main and backup servers are down, the SDK can continue to process purchases. This is enabled transparently to the user, and when the servers come back online, the SDK automatically syncs the information so it can be visible in the dashboard.
✨ Metadata allows attaching arbitrary information as key/value pairs to your Offering to control how to display your products inside your app. The metadata you configure in an Offering is available from the RevenueCat SDK. For example, you could use it to remotely configure strings on your paywall, or even URLs of images shown on the paywall.
See the metadata documentation for more info!
The first release candidate of RevenueCat Purchases Flutter v5 is here!! 😻
The first release candidate of RevenueCat Purchases Flutter v5 is here!! 😻
This latest release updates the Android SDK dependency from v5 to v6 to use BillingClient 5. This version of BillingClient brings an entire new subscription model which has resulted in large changes across the entire SDK.
SubscriptionOption conceptIn v4, a Google Play Android Package or StoreProduct represented a single purchaseable entity, and free trials or intro
offers would automatically be applied to the purchase if the user was eligible.
Now, in Flutter v5, an Google Play Android Package or StoreProduct represents a duration of a subscription and contains all the ways to
purchase that duration -- any offers and its base plan. Each of these purchase options are SubscriptionOptions.
When passing a Package to purchasePackage() or StoreProduct to purchaseStoreProduct(), the SDK will use the following logic to choose which
SubscriptionOption to purchase:
SubscriptionOption with the longest free trial or cheapest first phase
For more control, purchase subscription options with the new purchaseSubscriptionOption() method.
StoreProduct now has a few new properties use for Google Play Android:
defaultOption
Package or StoreProductsubscriptionOptions
Observer mode is still supported in v5. Other than updating the SDK version, there are no changes required.
purchaseProduct() is still deprecated but reverted back to same signature as 4.x.x
ProductType back to ProductCategoryPeriod now has PeriodUnit instead of UnitpurchaseProduct() is still deprecated but reverted back to same signature as 4.x.xThe first beta of RevenueCat Purchases Flutter v5 is here!! 😻
The first beta of RevenueCat Purchases Flutter v5 is here!! 😻
This latest release updates the Android SDK dependency from v5 to v6 to use BillingClient 5. This version of BillingClient brings an entire new subscription model which has resulted in large changes across the entire SDK.
SubscriptionOption conceptIn v4, a Google Play Android Package or StoreProduct represented a single purchaseable entity, and free trials or intro
offers would automatically be applied to the purchase if the user was eligible.
Now, in Flutter v5, an Google Play Android Package or StoreProduct represents a duration of a subscription and contains all the ways to
purchase that duration -- any offers and its base plan. Each of these purchase options are SubscriptionOptions.
When passing a Package to purchasePackage() or StoreProduct to purchaseStoreProduct(), the SDK will use the following logic to choose which
SubscriptionOption to purchase:
SubscriptionOption with the longest free trial or cheapest first phase
For more control, purchase subscription options with the new purchaseSubscriptionOption() method.
StoreProduct now has a few new properties use for Google Play Android:
defaultOption
Package or StoreProductsubscriptionOptions
Observer mode is still supported in v5. Other than updating the SDK version, there are no changes required.
The first alpha of RevenueCat Purchases Flutter v5 is here!! 😻
The first alpha of RevenueCat Purchases Flutter v5 is here!! 😻
This latest release updates the Android SDK dependency from v5 to v6 to use BillingClient 5. This version of BillingClient brings an entire new subscription model which has resulted in large changes across the entire SDK.
SubscriptionOption conceptIn v4, a Google Play Android Package or StoreProduct represented a single purchaseable entity, and free trials or intro
offers would automatically be applied to the purchase if the user was eligible.
Now, in Flutter v5, an Google Play Android Package or StoreProduct represents a duration of a subscription and contains all the ways to
purchase that duration -- any offers and its base plan. Each of these purchase options are SubscriptionOptions.
When passing a Package to purchasePackage() or StoreProduct to purchaseStoreProduct(), the SDK will use the following logic to choose which
SubscriptionOption to purchase:
SubscriptionOption with the longest free trial or cheapest first phase
For more control, purchase subscription options with the new purchaseSubscriptionOption() method.
StoreProduct now has a few new properties use for Google Play Android:
defaultOption
Package or StoreProductsubscriptionOptions
Observer mode is still supported in v5. Other than updating the SDK version, there are no changes required.
Fix deprecation warning (#694) via Andy Boedo (@aboedo)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.15.0 (#680) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.14.3 (#674) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.14.2 (#661) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.14.1 (#645) via RevenueCat Git Bot (@RCGitBot)
Deprecate revenueCatId in favor of transactionIdentifier (#612) via Toni Rico (@tonidero)
immediateAndChargeFullPrice proration mode (#639) via Andy Boedo (@aboedo)Deprecate usesStoreKit2IfAvailable (#632) via Andy Boedo (@aboedo)
usesStoreKit2IfAvailable (#632) via Andy Boedo (@aboedo)Bump fastlane from 2.212.0 to 2.212.1 (#627) via dependabot[bot] (@dependabot[bot])
Fixes NullPointerException at setUpdatedCustomerInfoListener (#621) via Cesar de la Vega (@vegaro)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.13.2 (#617) via RevenueCat Git Bot (@RCGitBot)
Add syncObserverModeAmazonPurchase (#609) via Cesar de la Vega (@vegaro)
syncObserverModeAmazonPurchase (#609) via Cesar de la Vega (@vegaro)Sends PurchasesCustomerInfoUpdatedEvent and PurchasesReadyForPromotedProductPurchaseEvent on UiThread (#600) via Cesar de la Vega (@vegaro)
Added Purchases.setLogHandler (#591) via Cesar de la Vega (@vegaro)
Purchases.setLogLevel (#589) via NachoSoto (@NachoSoto)DEVELOPMENT.md: added section on how to run tests (#590) via NachoSoto (@NachoSoto)Change default usesStoreKit2IfAvailable to false (#587) via Cesar de la Vega (@vegaro)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.8.0 (#572) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.7.0 (#566) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.5.4 (#558) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.5.3 (#553) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.5.2 (#550) via RevenueCat Git Bot (@RCGitBot)
Fix for java.lang.IllegalAccessError: Interface androidx.lifecycle.c (#547) via Cesar de la Vega (@vegaro)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.5.1 (#544) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.5.0 (#539) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.4.4 (#534) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.4.3 (#532) via RevenueCat Git Bot (@RCGitBot)
[AUTOMATIC BUMP] Updates purchases-hybrid-common to 4.4.1 (#528) via RevenueCat Git Bot (@RCGitBot)
Add setCleverTapId, setMixpanelDistinctID, setFirebaseAppInstanceId (#522) via Sergio Durban Belmonte (@sdurban)
Update fastlane-plugin-revenuecat_internal (#518) via Cesar de la Vega (@vegaro)
[AUTOMATIC] Updates purchases-hybrid-common to 4.3.2 (#502) via RevenueCat Git Bot (@RCGitBot)
Another fix on update_hybrid_common (#491) via Cesar de la Vega (@vegaro)
[AUTOMATIC] Updates purchases-hybrid-common to 4.2.2 (#476) via RevenueCat Git Bot (@RCGitBot)
purchaseProduct not working when SK2 is enabled
purchaseProduct not working when SK2 is enablednext_version and automatic_release to automatic_bump (#457) via Cesar de la Vega (@vegaro)Fixed crash when cancelling purchases (#403) via NachoSoto (@NachoSoto)
purchases-ios to 4.10.2SK2 as the default on iOSPurchasesFlutterPlugin: silenced unused warning (#444) via NachoSoto (@NachoSoto)README: removed Amazon note since it's now supported. (#442) via NachoSoto (@NachoSoto)Bump compileSdkVersion to version 31 (#436) via Toni Rico (@tonidero)
Fix for no-op calls on Android (enableAdServicesAttributionTokenCollection) (#434) via Josh Holtz (@joshdholtz)
New method for automatic collecting of attribution tokens on iOS and macOS using AdServices - Purchases.enableAdServicesAttributionTokenCollection()
Purchases.enableAdServicesAttributionTokenCollection() (https://github.com/RevenueCat/purchases-ios/pull/1727)purchases-hybrid-common to 4.0.2
In addition to all the changes included in the latest major release 4.0.0!
RevenueCat Flutter SDK v4 is here!!
RevenueCat Flutter SDK v4 is here!!
⚠️ ⚠️ Important ⚠️ ⚠️ Observer mode for Amazon is not supported yet.
We have introduced support for using the Amazon Appstore. We have extensively tested this, and there are some apps using our pre-release Amazon versions in production.
However, we have found some inconsistencies in the way Amazon Appstore prices are reported. We are actively working on patching these inconsistencies.
Please help us help you by reporting any issues you find. New RevenueCat Issue.
You can enable Amazon Appstore support by configuring the SDK using the new RevenueCatAPIKeyAmazon field.
For more information around configuration please take a look at the Amazon Appstore section in our docs. The official Amazon In-App Purchasing docs also contain very valuable information, especially around testing and best practices.
This version of the SDK automatically uses StoreKit 2 APIs under the hood only for APIs that the RevenueCat team has determined work better than StoreKit 1.
New types that wrap native types from Apple, Google and Amazon, and we cleaned up the naming of other types and methods for a more consistent experience.
| 3.x | 4.0.0 |
|---|---|
Purchases.setup |
Purchases.configure |
| 3.x | 4.0.0 |
|---|---|
IntroductoryPrice.periodUnit (String) |
IntroductoryPrice.periodUnit (PeriodUnit) |
IntroductoryPrice.introPrice |
IntroductoryPrice.price |
IntroductoryPrice.introPriceString |
IntroductoryPrice.priceString |
IntroductoryPrice.introPricePeriod |
IntroductoryPrice.period |
IntroductoryPrice.introPricePeriodNumberOfUnits |
IntroductoryPrice.periodNumberOfUnits |
IntroductoryPrice.introPriceCycles |
IntroductoryPrice.cycles |
Purchases.addAttributionData |
Set<NetworkID> |
Purchases.identify |
Purchases.logIn |
Purchases.createAlias |
Purchases.logIn |
Purchases.reset |
Purchases.logOut |
PurchasesAttributionNetwork |
Set<NetworkID> |
| 3.x | 4.0.0 |
|---|---|
PurchaserInfo |
CustomerInfo |
Transaction |
StoreTransaction |
Product |
StoreProduct |
Discount |
StoreProductDiscount |
PaymentDiscount |
PromotionalOffer |
Package.product |
Package.storeProduct |
Purchases.PurchaserInfoUpdateListener |
Purchases.CustomerInfoUpdateListener |
Purchases.removePurchaserInfoUpdateListener |
Purchases.removeCustomerInfoUpdateListener |
Purchases.restoreTransactions |
Purchases.restorePurchases |
Purchases.getPurchaseInfo |
Purchases.getCustomerInfo |
Purchases.invalidatePurchaserInfoCache |
Purchases.invalidateCustomerInfoCache |
Purchases.getPaymentDiscount |
Purchases.getPromotionalOffer |
Store enum has been moved from entitlement_info_wrapper.dart to store.dart## 4.0.0-rc.2 - Fixes userCancelled crash: PR
One column per quarter.