RevenueCat

Build With RevenueCat

Build a customized mobile subscription business with RevenueCat. We do the heavy lifting of normalizing subscribers from any source and maintain a single source of truth for subscription status, so you can get back to building your app.

RevenueCat is a powerful, secure, reliable, and free to use in-app purchase server with global support. All you need to get started is an API key.

Configuring Products

Use Entitlements and Offerings to organize and display products

Legacy Entitlements

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:

  1. Entitlements
  2. Offerings
  3. Products

Entitlements

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.

Offerings

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.

Products

Products are a one-to-one mapping of the product identifiers configured for your app in App Store Connect, Play Store and Stripe.

Configuration

1. Set up products in the app stores

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.

2. Add products to RevenueCat

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.

3. Configure Entitlements

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.

4. Configure Offerings

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.

Next Steps

Configuring Products


Use Entitlements and Offerings to organize and display products

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.