If your app is using the legacy version of Entitlements, you can view the old documentation and upgrade guide here.
The RevenueCat dashboard allows you to configure your available in-app products remotely so you can control how they're presented without the need to update your app. This is great for experimenting how different product configurations effect key subscription metrics.
There are three levels of product configuration available within RevenueCat:
An entitlement represents features or content that a user is "entitled" to.
Entitlements can be unlocked by having an active subscription or making a one-time purchase. Most subscription apps only have one entitlement, unlocking all premium features. However, if you had two tiers of content such as Pro and Pro Plus, you would have 2 entitlements.
If you have non-subscription products, you may or may not want to add them to entitlements depending on your use case. If the product is non-consumable (e.g. lifetime access to "pro" features), you likely want to attach it to an entitlement. However, if it is consumable (e.g. purchase more lives in a game) you likely do not want to add them to an entitlement. Whether a product is part of an entitlement or not, they can still be purchased the same way using the Purchases SDK. Learn more at Making Purchases.
The selection of products that are offered to a user.
Offerings allow you to choose which combination of products are shown to a user on your paywall or upsell screen. For example your default Offering may contain a monthly and annual subscription, but you might want to experiment with Offerings with a different combination of subscription durations, trial lengths, prices, etc.
Each Offering contains one or more Packages. Packages are simply a group of equivalent products across iOS and Android. If your app is available on multiple platforms, then a Package would contain all of the equivalent product Ids from each platform.
Any product can be added to an Offering, even if it's not part of any entitlement.
Products are a one-to-one mapping of the product identifiers configured for your app in App Store Connect, Play Store and Stripe.
Before products can be purchased, they need to be properly set up in App Store Connect, Play Console, and Stripe. If you've never set up products before or are experiencing issues, our posts on iOS and Android product setup may be useful.
If products are not configured correctly, you will see an invalid products message in the debug logs.
Navigate to the Products tab for your app in the RevenueCat dashboard. You'll see any previously purchased product identifiers already exist.
If you need to add more products, click the + New button and enter the product identifier and store it belongs to.
Products will also appear here automatically as they are purchased. If you see a product you never added manually, it means a receipt was sent from a user that contained that product Id.
Navigate to the Entitlements tab for your app in the RevenueCat dashboard and click + New to create a new entitlement.
You'll be prompted to enter an Identifier and Description for your entitlement then click Add.
Click into the newly created entitlement and begin attaching products by clicking Attach.
Choose one of your previously created products, or create a new one, and click Add. Repeat this process until all of your products are added.
Whenever a user purchases one of the assigned products, access to the entitlement will be unlocked for the appropriate duration.
Navigate to the Offerings tab for your app in the RevenueCat dashboard and click + New to create a new offering.
Again, you'll be prompted to enter an Identifier and Description for your offering. Note that the offering description cannot be changed later. Once you've entered this information, click Add.
Click into the newly created offering and set up the first Package by clicking + New.
In the popup, choose an Identifier from the dropdown that corresponds with the duration of the package. If a duration isn't suitable for your package (e.g. consumable purchases), then you can choose a custom identifier. Include a Description, then click Add.
Click into the newly created package and begin attaching product by clicking Attach.
In the popup you'll see dropdowns to select the appropriate product for each store. Choose the appropriate products, the click Attach.
Continue this process until all of the packages are created for your Offering, and all Offerings are created.
The packages within an offering can be updated at any time, and their display order can be modified by dragging their position in the table.
Updated 3 months ago