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.

Get Started    REST API Endpoints


Promotional subscriptions allow you to give a user access to premium content for a specific amount of time without requiring them to make a purchase or redeem a promo code. This can be useful for allowing beta users to preview content for free or resolving customer support issues.

Granting Promotionals

To give a user promotional access to an entitlement choose the entitlement name and duration and click 'Grant'. You can grant multiple entitlements if you have different levels of access. You must be using RevenueCat Entitlements to grant promotionals.

Granting an entitlement from the customer page will go into effect immediately, but you may need to refresh Purchaser Info on the client to get the latest active entitlements. The promotional access will automatically be revoked after the selected duration. Note that promotional entitlements in the customer timeline will not show as "sandbox" transactions.


Promotional entitlements will be prefixed with "rc_promo" in the customer dashboard.

Removing Promotional Subscriptions

Granted entitlements will automatically be removed after expiration. To remove access to an entitlement early, click the icon next to the Granted Entitlement name.


Promotional subscriptions won't affect billing

Promotional subscriptions are a RevenueCat specific feature and work independently of App Store or Play Store billing and will never: charge a user, issue a refund, or convert to a paid subscription.

Next Steps

Updated 4 months ago


Suggested Edits are limited on API Reference Pages

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