Subscription offers give you the opportunity to provide limited time discounts in order to attract or retain subscribers and can be an important part of a subscription lifecycle.

Introductory Offers & Free Trials

When an eligible user attempts to purchase a product that has an introductory offer (e.g. a free trial) the offer will be applied automatically.

If the introductory offer isn't applied to the purchase in the system payment sheet, double check that:

• The purchasing user is eligible, e.g. the underlying store account hasn't already purchased that product
• You've waited up to 24 hours for product propagation after adding the offer
• The free trial offer is marked as Backwards Compatible in Google Play Console (Google Play only)

📘

Introductory Offers applied automatically

The underlying stores apply introductory offers to purchases automatically and isn't something that RevenueCat's Purchases SDK controls.

Checking Eligibility

The Purchases SDK allows for easy checking of eligibility for introductory offers, so that you as the developer can display the proper subscription terms to your customers.

RevenueCat uses a best-effort approach to checking eligibility based on previous purchases by the customer. The native store payment sheet will ultimately display the correct eligibility before the customer subscribes.

Purchases.shared.getOfferings { offerings, error in
  if let product = offerings?.current?.availablePackages.first?.storeProduct {
    Purchases.shared.checkTrialOrIntroDiscountEligibility(product: product) { eligibility in
      if eligibility == .eligible {
        // show trial/introductory terms
      } else {
        // user is not eligible, show non-trial/introductory terms
      }
    }
  }
}

🚧

Google Play not supported

Checking introductory eligibility is not supported for Google Play at this time. Hybrid SDKs that use the checkTrialOrIntroductoryEligibility method will not return a valid eligibility on Android.

Setting up Subscription Offers

Apple App Store

Apple supports several types of subscription offers which we detail in our Apple Subscription Offers guide.

Google Play

📘

As of May 2022, Google Play supports multiple offers for subscription products. This is not yet supported by RevenueCat.

Read more in our community.

Google allows developers to set up Promo Codes to offer to customers.

Read more in our guide on Google Play Promo Codes.

Amazon Appstore

Amazon Appstore does not support subscription offers other than free trials.

Stripe

Free trials can be added to subscriptions through Stripe's dashboard and API. See our Stripe Free Trials guide for instructions.

Considerations

Offer Codes and Promo Codes

Due to limitations of available information for redeemable codes, accurate revenue tracking is not yet supported in the RevenueCat dashboard.

All initial purchases made with codes are assumed to be $0 transactions. Revenue from subsequent renewal transactions will be tracked normally.