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 11 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.
⚠️ ⚠️ Important ⚠️ ⚠️ Observer mode for Amazon is not supported yet.
⚠️ ⚠️ 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.dartYour coding agent can read these notes before it upgrades. Set up the MCP server →
⚠️⚠️ This is a pre-release version. ⚠️⚠️
⚠️⚠️ This is a pre-release version. ⚠️⚠️
purchaserInfo renamed to customerInfoStoreProduct, StoreTransaction and StoreProductDiscount. package.product to package.storeProductsetup changed with configureKnown issues: Amazon support currently doesn't work correctly in the Live App Testing and production environments. The purchase modal will not show correctly for Amazon in these environments.
Update purchases-ios to 3.14.4
Update purchases-ios to 3.14.4
Add support for iOS promoted purchases (https://github.com/RevenueCat/purchases-flutter/pull/344) New types: ReadyForPromotedProductPurchaseListener a
ReadyForPromotedProductPurchaseListener and PromotedPurchaseResult
New methods: addReadyForPromotedProductPurchaseListener(ReadyForPromotedProductPurchaseListener listener)
removeReadyForPromotedProductPurchaseListener(ReadyForPromotedProductPurchaseListener listenerToRemove)ReadyForPromotedProductPurchaseListener
New methods: addReadyForPromotedProductPurchaseListener(ReadyForPromotedProductPurchaseListener listener)
removeReadyForPromotedProductPurchaseListener(ReadyForPromotedProductPurchaseListener listenerToRemove)Add instructions for how to install Amazon Store version in README
This version of the SDK doesn't have support for Amazon Store. If you would like to use our SDK with Amazon Store, use the version tagged amazon-latest and follow the docs at https://docs.revenuecat.com/v3.4/docs/flutter#amazon-appstore to get set up.
Add back IntroductoryPrice fields that were accidentally removed without a major release
IntroductoryPrice.introPricePeriodUnit
IntroductoryPrice.introPrice
IntroductoryPrice.introPriceString
IntroductoryPrice.introPriceCycles
IntroductoryPrice.introPricePeriodNumberOfUnitsFix missing IntroductoryPrice export
Fix purchasePackage, purchaseProduct, purchaseDiscountedPackage and purchaseDiscountedProduct crashes due to a wrong type.
purchasePackage, purchaseProduct, purchaseDiscountedPackage and purchaseDiscountedProduct crashes due to a wrong type.Fixed a crash in getOfferings on Android for products that don't have intro pricing https://github.com/RevenueCat/purchases-flutter/pull/294 by @Natsu
getOfferings on Android for products that don't have intro pricing
https://github.com/RevenueCat/purchases-flutter/pull/294 by @NatsuOnFireFull Changelog: https://github.com/RevenueCat/purchases-flutter/compare/3.9.0...3.9.1
Breaking changes (these were unintended and fixed in 3.9.4): IntroductoryPrice.introPricePeriodUnit -> IntroductoryPrice.periodUnit (+ changed from st…
IntroductoryPrice.introPricePeriodUnit -> IntroductoryPrice.periodUnit (+ changed from string to PeriodUnit enum type)
IntroductoryPrice.introPrice -> IntroductoryPrice.price
IntroductoryPrice.introPriceString -> IntroductoryPrice.priceString
IntroductoryPrice.introPriceCycles -> IntroductoryPrice.cycles
IntroductoryPrice.introPricePeriodNumberOfUnits -> IntroductoryPrice.periodNumberOfUnitsAdded isConfigured, which returns true if the SDK has already been configured through setup.
isConfigured, which returns true if the SDK has already been configured through setup.EntitlementInfo.ownershipType for Android
https://github.com/RevenueCat/purchases-flutter/pull/278
https://github.com/RevenueCat/purchases-hybrid-common/pulls/106purchases-hybrid-common to 1.11.1 Changelog hereFull Changelog: https://github.com/RevenueCat/purchases-flutter/compare/3.7.0...3.8.0
isConfigured, which returns true if the SDK has already been configured through setup.EntitlementInfo.ownershipType for Android
https://github.com/RevenueCat/purchases-hybrid-common/pulls/106purchases-hybrid-common to 1.11.1 Changelog herepurchases-ios to 3.13.1 (Changelog here)purchases-android to 4.6.0 (Changelog here)Bumppurchases-hybrid-common to 1.11.0 Changelog here
Bumppurchases-hybrid-common to 1.11.0 Changelog here
Bumppurchases-hybrid-common to 1.10.0 Changelog here
purchases-hybrid-common to 1.10.0 Changelog herepurchases-ios to 3.13.0 (Changelog here)purchases-android to 4.4.0 (Changelog here)setAirshipChannelID
https://github.com/RevenueCat/purchases-flutter/pull/272Full Changelog: https://github.com/RevenueCat/purchases-flutter/compare/3.5.0...3.6.0
Removed call to Purchases.getSharedInstance().close(); in onDetachedFromEngine. This should fix an incompatibility with workmanager Flutter plugin tha
Purchases.getSharedInstance().close(); in onDetachedFromEngine. This should fix an incompatibility with workmanager Flutter plugin that was causing the BillingClient to get disconnected after a task would finish.close() function to be called in Android whenever the resources used by Purchases should be released.
https://github.com/RevenueCat/purchases-flutter/pull/268
https://github.com/RevenueCat/purchases-flutter/issues/257purchases-hybrid-common to 1.9.3 Changelog herepurchases-ios to 3.12.8
3.12.8 Changelog here
3.12.7 Changelog hereBumppurchases-hybrid-common to 1.9.2 Changelog here
purchases-hybrid-common to 1.9.2 Changelog herepurchases-android to 4.3.3
4.3.3 Changelog here
4.3.2 Changelog herepurchases-ios to 3.12.6
3.12.6 Changelog here
3.12.5 Changelog here
3.12.4 Changelog hereBumped purchases-android to 4.3.1 Changelog here, which fixes canMakePayments not returning (see related issue: https://github.com/RevenueCat/purchase
Buggy release - meant to update purchases-hybrid-common to 1.9.1 (and therefore purchases-android to 4.3.1), but didn't end up actually pulling it in.
Fixed more deprecation warnings for types used for compatibility with Flutter apps using Flutter < 1.12. https://github.com/RevenueCat/purchases-flutt…
Fixed deprecation warnings for types used for compatibility with Flutter apps using Flutter < 1.12. https://github.com/RevenueCat/purchases-flutter/pu…
purchases-hybrid-common to 1.8.2. Changelog here
https://github.com/RevenueCat/purchases-flutter/pull/233Fixed a bug where the wrong error code would be returned when mapping to JSON in Android.
purchases-hybrid-common to 1.8.1. Changelog here
https://github.com/RevenueCat/purchases-flutter/pull/225deprecates createAlias in favor of logIn.
In this version, we’ve redesigned the way that user identification works. Detailed docs about the new system are available here.
logIn, a new way of identifying users, which also returns whether a new user has been registered in the system.
logIn uses a new backend endpoint.logOut, a replacement for reset.createAlias in favor of logIn.identify in favor of logIn.reset in favor of logOut.setAllowSharingStoreAccount in favor of dashboard-side configuration.
https://github.com/RevenueCat/purchases-flutter/pull/180Update MacOS dependency on PurchasesHybridCommon to 1.7.1
Bump purchases-hybrid-common to 1.7.1 Changelog here
canMakePayments method (https://github.com/RevenueCat/purchases-flutter/pull/193)purchases-hybrid-common to 1.7.1 Changelog hereBumped purchases-hybrid-common to 1.6.3 to fix issues with overlapping Foundation extensions names in iOS Changelog here
Added link to examples in GitHub https://github.com/RevenueCat/purchases-flutter/pull/185
Added new Magic Weather sample app, available in revenuecat_examples/MagicWeather https://github.com/RevenueCat/purchases-flutter/pull/170
revenuecat_examples/MagicWeather
https://github.com/RevenueCat/purchases-flutter/pull/170Fixed an issue that would cause an error saying type 'Null' is not a subtype of type 'String' in type cast in allExpirationDates when null-safety is e
type 'Null' is not a subtype of type 'String' in type cast in allExpirationDates when null-safety is enabled.
https://github.com/RevenueCat/purchases-flutter/pull/177Added a new property simulateAsksToBuyInSandbox, that allows developers to test deferred purchases easily.
simulateAsksToBuyInSandbox, that allows developers to test deferred purchases easily.setSimulatesAskToBuyInSandbox, that allows developers to test deferred purchases easily.Fixes versions number in plugin files https://github.com/RevenueCat/purchases-flutter/pull/166
Fixes exception when calling getProducts and checkTrialOrIntroductoryPriceEligibility https://github.com/RevenueCat/purchases-flutter/issues/163 https
getProducts and checkTrialOrIntroductoryPriceEligibility
https://github.com/RevenueCat/purchases-flutter/issues/163
https://github.com/RevenueCat/purchases-flutter/pull/164Adds null safety support and increases minimum Dart SDK version to 2.12.0 https://github.com/RevenueCat/purchases-flutter/pull/155 https://github.com/
Fixed build issue on macOS targets https://github.com/RevenueCat/purchases-flutter/pull/151
Updated pubspec.yaml https://github.com/RevenueCat/purchases-flutter/pull/147
Updated pubspec.yaml https://github.com/RevenueCat/purchases-flutter/pull/143
removes deprecated getEntitlements, replaced by getOfferings
removes deprecated getEntitlements, replaced by getOfferings
removes deprecated makePurchase, replaced by purchaseProduct
iOS:
syncPurchases, that enables syncing the purchases in the local receipt with the backend without risking a password prompt. The method was already available on Android.presentCodeRedemptionSheet, for offer codes redemption.Bumped purchases-hybrid-common to 1.5.0 Changelog here
Bumped purchases-ios to 3.9.2 Changelog here
Bumped purchases-android to 4.0.1 Changelog here
Explicitly added Purchases framework to podspec's linker flags so it gets correctly linked in the plugin pod. Fixed mapping of xcconfig files in Runne
Purchases framework to podspec's linker flags so it gets correctly linked in the plugin pod.
Fixed mapping of xcconfig files in Runner example.
https://github.com/RevenueCat/purchases-flutter/pull/128Moved from valid architectures to excluded architectures in the Podfile, following Flutter's example. https://github.com/RevenueCat/purchases-flutter/
Bumped common files to 1.4.5 Changelog here
Bumped common files to 1.4.4 Changelog here
Build config updates to fix build issues on iOS:
purchases-hybrid-common version to 1.4.3Deprecated addAttribution in favor of setAdjustId, setAppsflyerId, setFBAnonymousId, setMparticleId.
addAttribution in favor of setAdjustId, setAppsflyerId, setFBAnonymousId, setMparticleId.setOnesignalIdsetMediaSource, setCampaign, setAdGroup, setAd, setKeyword, setCreative, and collectDeviceIdentifiers
https://github.com/RevenueCat/purchases-android/pull/184purchases-hybrid-common to 1.4.2 Changelog herepurchases-ios to 3.7.1 Changelog herepurchases-android to 3.5.0 Changelog hereFix a NullPointerException in the Android plugin
Bumped iOS to 3.4.0 Changelog here
setProxyURL (https://github.com/RevenueCat/purchases-flutter/pull/63)setFinishTransactions (https://github.com/RevenueCat/purchases-flutter/pull/45)Update README.md to remove macOS support
Adds Subscriber Attributes, which allow developers to store additional, structured information for a user in RevenueCat. More info: https://docs.reven
The header image in the package page is broken https://pub.dev/packages/purchases_flutter.
Fixes getOffering always returns null #19
Fixes crash when there's no offerings #17
Fixes issue with older versions of Kotlin
checkTrialOrIntroductoryPriceEligibility- Android updated to 3.0.3
Deprecates makePurchase methods. Replaces with purchasePackage
PurchasesErrorHelper.getErrorCode(PlatformException) and enum of PurchasesErrorCode to make handling errors easier. (#3)makePurchase methods. Replaces with purchasePackagegetEntitlements method. Replaces with getOfferingsrequestDate and PurchaserInfo missing properties #12.createAlias() method is no longer required, use .identify() instead.identify() will create an alias if being called from an anonymous ID generated by RevenueCatisAnonymous property to PurchasesDynamically access context and activity from registrar
Fixes expirationDate in EntitlementInfo for iOS.
expirationDate in EntitlementInfo for iOS.Fixes crash when there's a trial period and not an introductory price on Android.
Deprecates activeEntitlements in PurchaserInfo and adds entitlements object to PurchaserInfo. For more info check out https://docs.revenuecat.com/docs…
activeEntitlements in PurchaserInfo and adds entitlements object to PurchaserInfo. For more info check out https://docs.revenuecat.com/docs/purchaserinfomakePurchase with a bad product identifier in iOSmakePurchase missing the userCancelled boolean in AndroidmakePurchase not working in Android when calling with oldSkus parameterintroductoryPrice in the product information to get information around the trial period.Upgrades Android SDK to https://github.com/RevenueCat/purchases-android/releases/tag/2.3.1
Makes some changes to the introductory pricing due to some inconsistencies introduced in 0.2.0. Introductory pricing is now an object part of the prod
Upgrades iOS SDK to https://github.com/RevenueCat/purchases-ios/releases/tag/2.5.0
Fixes UninitializedPropertyAccessException when trying to close the instance onDestroy of the Android Activity.
- Formats files
One column per quarter.