What changed
Apple has introduced retention messages for auto-renewable subscriptions across its platforms. When an active subscriber navigates to their Apple account settings to cancel a recurring plan, the system can now present an in-flow retention message before final confirmation.
These messages serve to highlight your app’s core value or present an incentive to stay. A retention message can display:
- Informational copy explaining features or upcoming content the user will lose.
- Visual assets such as custom artwork or promotional banners.
- A discounted promotional offer or extended trial period to encourage renewal.
Configuration takes place directly within App Store Connect. You can define eligibility criteria—such as subscription tier or tenure—and set a required wait time (cool-down period) so subscribers do not see repetitive messaging during subsequent visits.
In addition to static rules set in the dashboard, Apple has introduced the Retention Messaging API. This server-to-server interface allows developers to evaluate incoming cancellation requests and dynamically select the optimal message or discount tier based on granular user engagement data. Access to the Retention Messaging API requires an approval request through your Apple Developer account.
Who is affected
This update affects any developer or organization offering auto-renewable subscriptions via StoreKit on iOS, iPadOS, macOS, watchOS, or tvOS.
Developers relying solely on one-time non-renewing subscriptions, consumable in-app purchases, or upfront paid downloads cannot use this feature. Apps with existing custom churn-prevention flows within their own interface are not restricted by this feature, but retention messages specifically address subscribers who bypass in-app cancellation prompts and cancel directly through iOS Settings or App Store account management.
What you need to do
Follow these steps to prepare, configure, and activate retention messages for your subscription groups.
1. Identify key churn segments and discount offers
Before enabling messages in the store, audit your churn analytics. Determine why subscribers typically cancel and decide whether copy reminders or commercial offers make financial sense. If you plan to offer promotional discounts:
- Create the corresponding win-back or promotional subscription offers inside App Store Connect.
- Confirm that your StoreKit 2 or server receipt validation endpoints handle win-back offer redemptions cleanly without entitlement gaps.
2. Configure static messages in App Store Connect
For standard retention messaging without custom backend logic:
- Sign in to App Store Connect and navigate to Apps.
- Select your app and go to the Subscriptions tab under the Features sidebar.
- Select the subscription group you want to modify.
- Locate the Retention Messages section.
- Click the add icon (
+) to draft a new message. - Provide the localized title, descriptive body text, and an optional image that adheres to Apple’s display specifications.
- Link an existing subscription offer if you are providing a temporary discount or billing pause equivalent.
3. Establish eligibility and cool-down intervals
Inside the retention message settings:
- Specify which subscriber groups qualify (for example, subscribers who have completed at least one renewal period).
- Define the wait time between impressions. Setting a minimum cool-down ensures a user who repeatedly opens the subscription management screen is not spammed with the same visual prompt.
- Save your changes and submit the metadata for review if required by the workflow.
4. Request Retention Messaging API access (optional)
If you track in-app engagement or customer health scores on your own servers and want to vary the retention offer based on external data:
- Go to your Apple Developer account dashboard.
- Submit a request for the Retention Messaging API entitlement.
- Once granted, configure your server endpoints to exchange tokens with Apple’s retention verification service.
- Write logic to parse incoming cancellation events and return the chosen payload identifier before the native sheet renders to the user.
Key dates
- November 04, 2026: Retention messages and the Retention Messaging API became available to developers in App Store Connect.
FAQ
Does a retention message prevent a subscriber from completing cancellation?
No. Apple does not allow blocking cancellations. The retention message appears as an intermediate informational step. The subscriber retains the option to decline the message or offer and complete the cancellation immediately.
Do retention messages require an app update or new SDK build?
No app client update is required for standard configuration. Because the cancellation interface is hosted natively by Apple’s account management sheet and App Store infrastructure, changes configured in App Store Connect take effect server-side for existing installations.
Can I offer different messages based on how long a user has subscribed?
Yes. App Store Connect configuration options include eligibility rules based on subscription history. For more complex segmentation based on in-app behavioral metrics, you must request access to the Retention Messaging API.