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: cancel a user's subscription, charge a user, issue a refund, or convert to a paid subscription.

Promotionals don't stack on top of store subscriptions, and are applied alongside them instead.

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


Looking for the REST API endpoint?

Grant and revoke promotional entitlements via our REST API as described here.

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 CustomerInfo 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.

Next Steps