introductoryPriceNumberOfPeriodsIOS incorrect?

[jslok]

This value shoud be the number of days the free trial is for right? Like 3 days? I have a 3 day free trial offer but introductoryPriceNumberOfPeriodsIOS only shows 1.

[hyochan]

The current implementation is correct. introductoryPriceNumberOfPeriodsIOS represents the number of period units, not the number of days.

Your 3-Day Free Trial

For your 3-day free trial offer:

• introductoryPriceNumberOfPeriodsIOS = "1" ✅ (one period)
• introductoryPriceSubscriptionPeriodIOS = "DAY" (the unit)
• Period value = 3 (configured in App Store Connect)

This means: 1 period × 3 days = 3-day free trial

Why It Shows 1, Not 3

The periodCount represents how many billing cycles the offer lasts, not the total number of days.

Examples

Offer Configuration	periodCount	What It Means
3-day free trial	1	1 period of 3 days
3-month free trial	1	1 period of 3 months
3 weeks at 50% off	3	3 periods of 1 week each
6 months at 50% off	6	6 periods of 1 month each

How to Calculate Total Days

To get the actual number of days:

total days = periodCount × period.value × (unit converted to days)

For your case:
1 (periodCount) × 3 (period.value) × 1 (day) = 3 days ✅

Apple's Official Documentation

This behavior matches Apple's StoreKit API specification:

• Product.SubscriptionOffer.periodCount - The number of periods that the subscription offer renews
• Product.SubscriptionPeriod - A description of a subscription period

The periodCount property returns the number of billing cycles, not the total duration in days.