App Store retention messages: what Apple's new subscription feature does
Apple now lets developers show text, image or offer messages inside the subscription cancellation flow. What you can configure, the API, and what to decide first.
Apple has given subscription apps a new way to keep customers who are about to leave. On 4 November 2026, Apple announced that retention messages for subscriptions are now available: a message from the developer that appears inside the App Store's cancellation flow, at the moment a subscriber is deciding whether to cancel.
This guide summarizes Apple's announcement and what it means for an app business. It is based on Apple's developer news post, checked on 19 November 2026. It does not replace the App Store Connect documentation, and eligibility details for your specific subscriptions should be confirmed in your own account.
What a retention message is
A retention message is shown in the cancellation flow and can include text, images or a special offer. Apple's stated purpose is to reduce cancellations by reminding subscribers of the subscription's value while they are deciding. This happens inside Apple's own cancellation experience, not inside your app, so it reaches people who went to cancel rather than people still actively using the product.
What you can configure in App Store Connect
According to the announcement, App Store Connect lets you configure retention messages for your auto-renewable subscriptions, including:
- Subscriber eligibility - which subscribers see a message.
- Wait time between offers - how long Apple waits before showing an offer to the same subscriber again.
The message content can be text, an image, or a special offer such as a discount, as shown in Apple's own example screenshots of a cancellation screen with a developer message.
The Retention Messaging API
Beyond the App Store Connect configuration, Apple offers a Retention Messaging API that lets the developer choose which message to show each subscriber based on that subscriber's subscription details. API access is available by request, not automatically. For most teams, the practical path is to start with the App Store Connect configuration and treat the API as a later step if per-subscriber targeting proves necessary.
What to decide before switching it on
- Your cancellation reasons. A retention message works best when it answers the actual reason people cancel. If you do not know why subscribers leave, a discount in the cancellation flow may simply discount customers who would have stayed.
- Offer economics. A special offer in the cancellation flow changes your effective price for the subscribers most likely to leave. Model what that does to revenue per subscriber before making the offer generous.
- Measurement. Decide upfront how you will judge whether the message works - cancellation completion rate with and without the message - rather than reading a single month's churn.
- Eligibility and frequency. The eligibility and wait-time settings exist so the same subscriber is not shown offers repeatedly. Configure them deliberately; a subscriber who learns that canceling produces a discount has a reason to cancel again next period.
Where this fits with other App Store changes
Retention messages arrive alongside other App Store commercial changes. Apple has separately published tax and price updates taking effect in December 2026 and January 2027, which we summarized for app teams. If you sell subscriptions, both belong in the same planning cycle, and the privacy label and account-deletion requirements remain part of any subscription app's store presence. For the product side of an iOS subscription build, our iOS app development page explains how we scope engagements.
Sources
- Apple Developer News, Now available: Retention messages for subscriptions (4 November 2026): https://developer.apple.com/news/?id=fk9ps3gv
- App Store Connect, auto-renewable subscriptions documentation (linked from the announcement): https://developer.apple.com/app-store/subscriptions/
Drafted with AI assistance from these sources. Availability and configuration options can change; confirm the current behavior in App Store Connect and Apple's documentation for your own subscriptions.