iOS Introductory Prices: Types, StoreKit Data, and Eligibility
Introductory pricing lets a subscription start below its normal price, or at no charge, before regular billing begins. The useful design choice is not only the headline price: you also need to decide how many periods it covers, how long each period lasts, and whether the buyer has already used an introductory offer in the same subscription group.
Choose the mode by renewal pattern
Apple introduced introductory pricing for in-app subscriptions in iOS 11.2. The three modes are pay as you go, pay up front, and free trial. They differ mainly in how the discounted or free period is spread across renewals.
Pay as you go: a reduced price applies for a set number of renewal periods, then the regular price begins. The introductory price must be lower than the regular price. Each introductory period must match the regular product duration, so a weekly introductory period cannot lead into a monthly subscription. The whole introductory period can last up to one year, except that a one-week subscription is capped at 12 weeks.
Pay up front: one period uses a price and duration you choose, after which regular pricing takes over. Unlike pay as you go, this introductory price does not have to be lower than the regular price. That flexibility makes it suitable for a long discounted first period followed by shorter renewals.
Free trial: this follows the pay-up-front pattern at $0.00 and adds three-day, one-week, and two-week durations. The older free-trial API was described as likely to be deprecated.
What to display from SKProductDiscount
Apple added an optional introductoryPrice property to SKProduct in iOS 11.2. If a product has an introductory price, SKProduct.introductoryPrice will be non-nil. That SKProductDiscount object carries the information needed for the purchase screen:
- price and price locale for display
- payment mode: payAsYouGo, payUpFront, or freeTrial
- number of periods: relevant to pay as you go, and always 1 for pay up front and free trial
- subscription period, such as one month or two months
Fetch this data from StoreKit for the purchase flow instead of hard-coding offer details beyond product identifiers. The App Store purchase interface presents the correct price, but your own interface still needs the fetched offer details to describe the introductory period accurately.
Eligibility: group-level, not product-only
Eligibility is the difficult part. Completing an introductory period in one subscription group removes introductory pricing for every other product in that group. The older manual approach required refreshing and validating the receipt, parsing past purchases, and mapping products to their subscription groups. That added remote work before prices could be shown.
From iOS 12.0, a product exposes its subscription group identifier, making a local comparison possible: refresh the receipt, find purchases made with introductory pricing, convert the relevant identifiers to products, and treat the user as ineligible if any prior introductory purchase matches the product or its group. A server fallback was still needed for older operating systems.
On iOS 15 and later, the direct route is simpler: get the products by calling products(for:), then check product.subscription.isEligibleForIntroOffer. The same newer check is available on tvOS 15+, watchOS 8+, and macOS 12+. Apps supporting older systems still need the older eligibility logic or another implementation path.
Pre-launch checklist
Use this checklist before shipping an introductory offer:
- Pick the mode that matches the intended renewal pattern, not just the lowest first price.
- Confirm the introductory period duration matches the regular subscription duration where required.
- Fetch price, locale, payment mode, period count, and subscription period from StoreKit for display.
- Decide eligibility by subscription group, not by product identifier alone.
- Choose the direct eligibility check on supported newer systems and retain a fallback for older systems.
- Test a buyer who has already completed an introductory period in the same group against a buyer who has not.
Frequently asked questions
What are the three introductory price types?
Pay as you go repeats a reduced price over several renewal periods. Pay up front applies one chosen price for a single period. A free trial is the pay-up-front pattern at $0.00, with additional short durations of three days, one week, and two weeks.
Why can a user lose introductory pricing for a different product?
After a user completes an introductory period for a product in a subscription group, introductory pricing is no longer available for other products in that same group. Eligibility therefore has to be checked at group level, not only for the exact product being sold.
How do I check eligibility on newer and older iOS versions?
On iOS 15 and later, get the products by calling products(for:) and check product.subscription.isEligibleForIntroOffer. On older systems, the older route involves refreshing and validating the receipt, parsing prior introductory purchases, and comparing product or subscription-group identifiers.