App Store Connect Analytics Help
Subscriptions
Auto-renewable subscriptions are In-App Purchases that provide ongoing access to content, features, or services in exchange for a recurring charge. Subscriptions renew automatically until a user cancels, and can include free trials, introductory offers, promotional offers, and multiple pricing durations, giving you flexibility in how access is granted and maintained over time.
Analytics in App Store Connect helps you understand the full subscription lifecycle, from trial starts to conversions, renewals, recoveries, and churn. You can also measure active plans, free trials, paid offers, conversions, renewals, involuntary churn, voluntary churn, and recoveries across all pricing states (such as full price, preserved price, and contingent price). These metrics help you evaluate acquisition, retention, and monetization in one place.
You can also leverage cohort analysis to measure payer conversion and long-term subscriber retention. Learn more about cohorts.
To export subscription data in bulk, use the Analytics reports in the App Store Analytics API. Subscription data appears in Analytics once your app has at least one active subscription product and subscriber.
Learn about configuring subscriptions in App Store Connect
View subscriptions data
-
In Apps, select the app you want to view.
-
Click the Analytics tab.
-
In the sidebar under Monetization, click Subscriptions.
-
The Subscriptions dashboard displays key performance metrics like Active Plans, Paid Plans, and Monthly Recurring Revenue. Below these, it presents Net Paid Plans alongside key subscription metrics such as Plan Starts, Conversion to Paid, Churn, and Paid to Offer. Use the drop down menu to view data for an individual subscription or subscription group.
-
If you're managing numerous subscription products and prefer a table view over the visual dashboard, click 'View List' in the upper right corner. This action will display your subscription plans in a detailed table format, allowing for easy, side-by-side comparison of key metrics across all your offerings.
-
For a more granular analysis of your data, navigate to the Metrics tab. Here, you can apply various filters, such as territory or device type
Subscription events
Available once your app has sold at least one subscription, unless otherwise noted in the Feature adoption column.
|
Metric |
Definition |
Grouping |
Feature adoption |
|---|---|---|---|
|
Offer Starts (All) |
The number of offers that began. |
Offer Starts |
Subscription Offer |
|
Free Trial Start |
Number of plans beginning a free trial period. |
Offer Starts |
Free Trials |
|
Paid Offer Start |
Number of plans beginning a paid offer period. |
Offer Starts |
Paid Offers |
|
Offer Renewals (All) |
Number of offers that renewed to the next period. |
Offer Renewals |
Subscription Offer |
|
Free Trial Renewals |
Number of free trials that renewed to the next period. |
Offer Renewals |
Free Trials |
|
Paid Offer Renewals |
Number of paid offers that renewed to the next period. |
Offer Renewals |
Paid Offers |
|
Paid Subscriptions from Offers (All) |
Number of offers that converted into full price subscriptions. |
Paid Subscriptions from Offers |
Free Trials |
|
Full Price from Free Trial |
Number of free trials that converted into full price subscriptions. |
Paid Subscriptions from Offers |
Free Trial |
|
Contingent Price from Free Trial |
Number of free trials that converted into contingent price subscriptions. |
Paid Subscriptions from Offers |
Free Trials and Contingent Price |
|
Full Price from Paid Offer |
Number of paid offers that converted into full price subscriptions. |
Paid Subscriptions from Offers |
Paid Offers |
|
Contingent Price from Paid Offer |
Number of paid offers that converted into contingent price subscriptions. |
Paid Subscriptions from Offers |
Paid Offer and Contingent Price |
|
Paid Subscription Starts (All) |
The number of new paid subscriptions that began. |
Paid Subscription Starts |
N/A |
|
Full Price Subscription Start |
Number of new subscriptions that began at full price. |
Paid Subscription Starts |
N/A |
|
Contingent Price Subscription Start |
Number of new subscriptions that began at a contingent price. |
Paid Subscription Starts |
Contingent Price |
|
Renewals (All) |
The number of paid subscriptions that renewed. |
Renewals |
N/A |
|
Full Price Renewals |
Number of full price subscriptions that renewed at full price. |
Renewals |
N/A |
|
Preserved Price Renewals |
Number of preserved price subscriptions that renewed at a preserved price. |
Renewals |
Preserved Price |
|
Contingent Price Renewals |
Number of contingent price subscriptions that renewed at a contingent price. |
Renewals |
Contingent Price |
|
Contingent Price Renewal from Full Price |
Number of renewals that changed to contingent price from full price. |
Renewals |
Contingent Price |
|
Contingent Price Renewal from Preserved Price |
Number of renewals that changed to contingent price from preserved price. |
Renewals |
Contingent Price and Preserved Price |
|
Full Price Renewal from Contingent Price |
Number of renewals that changed to full price from contingent price. |
Renewals |
Contingent Price |
|
Preserved Price Renewal from Contingent Price |
Number of renewals that changed to preserved price from contingent price. |
Renewals |
Contingent Price and Preserved Price |
|
Preserved Price Renewal from Full Price |
Number of renewals that changed to preserved price from full price. |
Renewals |
Preserved Price |
|
Full Price Renewal from Preserved Price |
Number of renewals that changed to full price from preserved price. |
Renewals |
Preserved Price |
|
Entered Billing Issue (All) |
The number of subscriptions that entered a billing issue state. |
Entered Billing Issue |
N/A |
|
Entered Grace Period from Full Price |
Number of full-price subscriptions that entered a grace period after a failed renewal. |
Entered Billing Issue |
Grace Period |
|
Entered Grace Period from Contingent Price |
Number of contingent-price subscriptions that entered a grace period after a failed renewal. |
Entered Billing Issue |
Grace Period and Contingent Price |
|
Entered Grace Period from Preserved Price |
Number of preserved-price subscriptions that entered a grace period after a failed renewal. |
Entered Billing Issue |
Grace Period and Preserved Price |
|
Entered Grace Period from Free Trial |
Number of free trials that entered a grace period due to failed billing. |
Entered Billing Issue |
Grace Period and Free Trial |
|
Entered Grace Period from Paid Offer |
Number of paid offers that entered a grace period due to failed billing. |
Entered Billing Issue |
Grace Period and Paid Offer |
|
Entered Billing Retry from Full Price |
Number of full-price subscriptions that entered billing retry after a failed renewal. |
Entered Billing Issue |
N/A |
|
Entered Billing Retry from Contingent Price |
Number of contingent-price subscriptions that entered billing retry after a failed renewal. |
Entered Billing Issue |
Contingent Price |
|
Entered Billing Retry from Preserved Price |
Number of preserved-price subscriptions that entered billing retry after a failed renewal. |
Entered Billing Issue |
Preserved Price |
|
Entered Billing Retry from Free Trial |
Number of free trial conversions that entered billing retry after failed billing. |
Entered Billing Issue |
Free Trial |
|
Entered Billing Retry from Paid Offer |
Number of paid offers that entered billing retry after a failed renewal. |
Entered Billing Issue |
Paid Offer |
|
Entered Billing Retry from Grace Period (All) |
Number of subscriptions that moved from grace period into billing retry. |
Entered Billing Retry from Grace Period |
Grace Period |
|
Recoveries from Billing Issue (All) |
The number of subscriptions that recovered from a billing issue. |
Recoveries from Billing Issue |
N/A |
|
Full Price Recoveries from Grace Period |
Number of subscriptions that recovered from grace period and renewed at full price. |
Recoveries from Billing Issue |
Grace Period |
|
Contingent Price Recoveries from Grace Period |
Number of subscriptions that recovered from grace period and renewed at contingent price. |
Recoveries from Billing Issue |
Contingent Price and Grace Period |
|
Preserved Price Recoveries from Grace Period |
Number of subscriptions that recovered from grace period and renewed at preserved price. |
Recoveries from Billing Issue |
Preserved Price and Grace Period |
|
Paid Offer Recoveries from Grace Period |
Number of subscriptions that recovered from grace period into a paid offer period. |
Recoveries from Billing Issue |
Paid Offer and Grace Period |
|
Full Price Recoveries from Billing Retry |
Number of subscriptions that recovered from billing retry and renewed at full price. |
Recoveries from Billing Issue |
N/A |
|
Contingent Price Recoveries from Billing Retry |
Number of subscriptions that recovered from billing retry and renewed at contingent price. |
Recoveries from Billing Issue |
Contingent Price |
|
Preserved Price Recoveries from Billing Retry |
Number of subscriptions that recovered from billing retry and renewed at preserved price. |
Recoveries from Billing Issue |
Preserved Price |
|
Paid Offer Recoveries from Billing Retry |
Number of subscriptions that recovered from billing retry into a paid offer period. |
Recoveries from Billing Issue |
Paid Offer |
|
Involuntary Churns (All) |
The number of subscriptions that churned due to billing issues. |
Involuntary Churns |
N/A |
|
Involuntary Churns from Free Trials |
Number of free trial subscriptions that ended due to payment failure. |
Involuntary Churns |
Free Trial |
|
Involuntary Churns from Paid Offers |
Number of paid offer subscriptions that ended due to payment failure. |
Involuntary Churns |
Paid Offer |
|
Involuntary Churns from Full Price |
Number of full-price subscriptions that ended due to payment failure. |
Involuntary Churns |
N/A |
|
Involuntary Churns from Contingent Price |
Number of contingent-price subscriptions that ended due to payment failure. |
Involuntary Churns |
Contingent Price |
|
Involuntary Churns from Preserved Price |
Number of preserved-price subscriptions that ended due to payment failure. |
Involuntary Churns |
Preserved Price |
|
Voluntary Churns (All) |
The number of subscriptions that churned due to user cancellation. |
Voluntary Churns |
N/A |
|
Voluntary Churns from Free Trials |
Number of free trial subscriptions that ended by user cancellation. |
Voluntary Churns |
Free Trial |
|
Voluntary Churns from Paid Offers |
Number of paid offer subscriptions that ended by user cancellation. |
Voluntary Churns |
Paid Offer |
|
Refunds from Paid Offers |
Number of paid-offer plans that were refunded. |
Voluntary Churns |
Paid Offer |
|
Voluntary Churns from Full Price |
Number of full-price subscriptions that ended by user cancellation. |
Voluntary Churns |
N/A |
|
Voluntary Churns from Contingent Price |
Number of contingent price subscriptions that ended by user cancellation. |
Voluntary Churns |
Contingent Price |
|
Voluntary Churns from Preserved Price |
Number of preserved price subscriptions that ended by user cancellation. |
Voluntary Churns |
Preserved Price |
|
Refunds from Full Price |
Number of full-price transactions that were refunded. |
Voluntary Churns |
N/A |
|
Refunds from Contingent Price |
Number of contingent-price transactions that were refunded. |
Voluntary Churns |
Contingent Price |
|
Refunds from Preserved Price |
Number of preserved-price transactions that were refunded. |
Voluntary Churns |
Preserved Price |
|
Exits (All) |
The number of full-paid plans and offers that ended because a different full-paid plan or offer began. |
Exits |
N/A |
|
Plan Changes |
Number of plans where the user chose to upgrade, crossgrade, or downgrade to a different plan. |
Exits |
N/A |
|
Offer to Offer |
The number of offers that changed to a different offer. |
Exits |
Subscription Offer |
|
Offers from Paid |
The number of existing paid subscriptions that changed to an offer. |
Exits |
Subscription Offer |
|
Extensions (All) |
The total number of subscriptions that were provided with a renewal extension. |
Extensions |
N/A |
|
Free Trial Extensions |
The number of free trials that were provided with a renewal extension. |
Extensions |
Free Trial |
|
Paid Offer Extensions |
The number of paid offers that were provided with a renewal extension. |
Extensions |
Paid Offer |
|
Contingent Price Extensions |
The number of contingent price subscriptions that were provided with a renewal extension. |
Extensions |
Contingent Price |
|
Preserved Price Extensions |
The number of preserved price subscriptions that were provided with a renewal extension. |
Extensions |
Preserved Price |
Subscription states
Available once your app has sold at least one subscription, unless otherwise noted in the Feature adoption column.
|
Metric |
Definition |
Grouping |
Feature adoption |
|---|---|---|---|
|
Active Plans (All) |
The total number of active subscriptions, including free trials, paid offers, and paid subscriptions. Does not include plans in billing retry or grace period. |
Active Plans |
N/A |
|
Subscription Offers (All) |
The number of active free trials and paid offers. |
Subscription Offers |
Subscription Offer |
|
Free Trials |
Number of active subscriptions in a free trial state. |
Subscription Offers |
Free Trials |
|
Paid Offers |
Number of active subscriptions in a paid offer state. |
Subscription Offers |
Paid Offers |
|
Paid Plans (All) |
The number of active full-price, preserved-price, and contingent-price subscriptions. |
Paid Plans |
N/A |
|
Full Price |
Number of active subscriptions paying the full subscription price. |
Paid Plans |
N/A |
|
Preserved Price |
Number of active subscriptions paying a preserved price. |
Paid Plans |
Preserved Price |
|
Contingent Price |
Number of active subscriptions paying a contingent price. |
Paid Plans |
Contingent Price |
|
Billing Issue (All) |
Number of active subscriptions that failed to renew because of a billing issue, and Apple is attempting to recover the payment. |
Billing Issue |
N/A |
|
Grace Period |
Number of active subscriptions with a billing issue in a billing grace period. |
Billing Issue |
Grace Period |
|
Billing Retry |
Number of active subscriptions with a billing issue, and not in a billing grace period. |
Billing Issue |
N/A |
|
Churned (All) |
Number of inactive subscriptions. Only subscriptions that churned within the last two years are reported. |
Churned |
N/A |
|
Voluntary Churn |
Number of inactive subscriptions that churned because the user chose to cancel. |
Churned |
N/A |
|
Involuntary Churn |
Number of inactive subscriptions that churned because of a billing issue and Apple was not able to recover the payment within the 60 day retry window. |
Churned |
N/A |
Subscription rates
Available once your app has sold at least one subscription, unless otherwise noted in the Feature adoption column.
|
Metric |
Definition |
Feature adoption |
|---|---|---|
|
Conversion Rate (All) |
The percentage of completed offers that converted to a paid subscription. |
Subscription Offer |
|
Trial to Paid Conversion |
The percentage of completed trial offers that converted to a paid subscription. |
Subscription Offer and Free Trial Offers |
|
Paid Offer to Paid Conversion |
The percentage of completed paid offers that converted to a paid subscription. |
Subscription Offer and Paid Offers |
|
Monthly Recurring Revenue |
The amount of revenue earned from active paid subscriptions, normalized to a monthly timeframe. |
N/A |
Filters and dimensions
Available once your app has sold at least one subscription. Some dimensions are only enabled once you adopt additional features, for example the offer name, family sharing, and duration dimensions.
|
Dimension |
Definition |
Applicable to |
Sample Values |
|---|---|---|---|
|
Subscription Group Name |
The group that the subscription belongs to, as set by you in App Store Connect. |
State and Event Metrics |
Premium Access, Basic Access |
|
Subscription Group ID |
The unique identifier assigned to the subscription group by Apple. |
State and Event Metrics |
|
|
Subscription Name |
The name of the subscription that the user has subscribed to, as set by you in App Store Connect. |
State and Event Metrics |
Premium Access, Basic Monthly, Monthly Annual |
|
Subscription Adam ID |
The unique identifier assigned to the subscription by Apple. |
State and Event Metrics |
|
|
Subscription Duration |
The duration of the subscription that the user has subscribed to. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Subscription Pricing |
The pricing mechanism associated with the paid subscription. |
State and Event Metrics |
Full Price, Preserved Price, Contingent Price |
|
Offer Type |
Type of subscription offer the user has redeemed. |
State and Event Metrics |
Introductory Offer, Offer Code, Promotional Offer, Winback Offer |
|
Offer Pricing |
The pricing mechanism associated with the offer redeemed by the user. |
State and Event Metrics |
Free Trial, Pay As You Go, Pay Up Front |
|
Offer Duration |
The duration of the subscription offer that the user has redeemed. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Offer Name |
The name of the subscription offer, as set by you in App Store Connect. |
State and Event Metrics |
Spring 2020, Thanksgiving Free Trial Code |
|
Offer ID |
The offer ID of the subscription offer, as set by you in App Store Connect. |
State and Event Metrics |
|
|
Custom Code |
The custom code associated with the offer code, as set by you in App Store Connect. |
State and Event Metrics |
|
|
Initial Offer Start Date |
The date the customer started their initial free trial or paid offer. In the case of a stacked offer, the first offer date is captured. |
State and Event Metrics |
Date picker - supported granularity: day, week, month |
|
Initial Offer Name |
The subscription offer name of the initial subscription offer. |
State and Event Metrics |
Spring 2020, Thanksgiving Free Trial Code |
|
Initial Offer ID |
The offer ID of the initial subscription offer. |
State and Event Metrics |
|
|
Initial Offer Type |
The offer type of the initial subscription offer. |
State and Event Metrics |
Introductory Offer, Offer Code, Promotional Offer, Winback Offer |
|
Initial Offer Pricing |
The offer pricing of the initial subscription offer. |
State and Event Metrics |
Free Trial, Pay As You Go, Pay Up Front |
|
Initial Offer Duration |
Offer duration of the initial subscription offer. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Paid Subscription Start Date |
The date the customer initially started paying the full price or contingent price. |
State and Event Metrics |
Date picker - supported granularity: day, week, month |
|
Offer Start Date (Last Offer Start Date) |
The date the customer started the most recent free trial or paid offer. |
State and Event Metrics |
Date picker - supported granularity: day, week, month |
|
Last Offer Name |
Subscription offer name of the most recent subscription offer. |
State and Event Metrics |
Spring 2020, Thanksgiving Free Trial Code |
|
Last Offer ID |
Offer ID of the most recent subscription offer. |
State and Event Metrics |
|
|
Last Offer Type |
Type of most recent subscription offer redeemed by the user. |
State and Event Metrics |
Introductory Offer, Offer Code, Promotional Offer, Winback Offer |
|
Last Offer Pricing |
Offer pricing of the most recent subscription offer redeemed by the user. |
State and Event Metrics |
Free Trial, Pay As You Go, Pay Up Front |
|
Last Offer Duration |
Offer duration of the most recent subscription offer redeemed by the user. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Paid Tenure |
Days of paid service accumulated. Rounded down to the nearest year. |
State and Event Metrics |
<1 year, 1 year, 2 years, 3 years, 4 years, >=5 years |
|
Previous State |
Previous state associated with the subscription. |
Event Metrics |
Free Trial, Paid Offer, Full Price, Preserved Price, Contingent Price, Grace Period, Billing Retry, Voluntary Churn, Involuntary Churn |
|
Current State |
Current state associated with the subscription. |
Event Metrics |
Free Trial, Paid Offer, Full Price, Preserved Price, Contingent Price, Grace Period, Billing Retry, Voluntary Churn, Involuntary Churn |
|
Active State Prior to Billing Issue |
Previous active state prior to billing issue. Applicable only to recovery from billing issue events and involuntary churn events. |
Event Metrics |
Free Trial, Paid Offer, Full Price, Preserved Price, Contingent Price |
|
Previous Subscription Adam ID |
The previous subscription Adam ID the user was subscribed to before they changed plans. |
Event Metrics |
|
|
Previous Subscription Name |
The previous subscription the user was subscribed to before they changed plans. |
Event Metrics |
|
|
Plan Change Type |
Indicates upgrades, crossgrades, and downgrades. |
Event Metrics |
Upgrades, Crossgrades, and Downgrades |
|
Cancellation Reason |
The reason why the subscription was canceled. |
State and Event Metrics |
|
|
Family Sharing |
Indicates whether a user is sharing the subscription with their iCloud family. |
State and Event Metrics |
Individual, Shared with Family |