Definition
What Retention Messaging is
Retention Messaging is a tool Apple announced at WWDC 2026 for the auto-renewable subscription cancellation flow. When a subscriber moves to cancel, you can show custom messaging about your subscription's value, your own imagery, or a special offer, without adding friction to the cancel flow itself. It is coming this fall.
There are two ways to configure it:
- App Store Connect: set messaging and offers in the interface.
- Retention Messaging API: interact with subscribers in real time and configure additional options programmatically.
What it is not
Retention Messaging fires during the cancel flow, before the cancellation completes. That makes it different from a few adjacent things:
- A win-back targets people who have already lapsed, after cancellation.
- A promotional offer or offer code is a price incentive you configure separately. A retention message can surface one of those, but it is the messaging surface, not the discount mechanism.
- An introductory offer runs at the start of a subscription, not at the end.
The anchor caveat
A retention offer only works if the price it discounts was right to begin with. A save offer shown off a base price that was never localized is a discount off the wrong anchor: 20% off a price that is already 3x too high in a market is still too high. Retention Messaging is most useful on top of prices that already fit each country, not as a patch for a base price that does not.
Cross-store note
This is an Apple feature. Google Play has its own cancellation-survey and win-back surfaces, configured separately in Play Console. The mechanics and timing differ between the two stores.
Examples
A save offer during cancellation
A subscriber on a $9.99/month plan taps cancel. With the Retention Messaging API, the app shows a tailored message: a reminder of features they have not used, plus a one-tap offer of 50% off the next three months.
If that $9.99 was localized to the subscriber's country, the save offer is a genuine nudge. If $9.99 was a raw currency conversion that lands at 3x local willingness-to-pay, the retention offer is papering over a base-price problem, and you burn margin on every cancel attempt instead of fixing the price.
Frequently asked
What is Retention Messaging on the App Store?
A tool, announced at WWDC 2026, that lets developers show custom messaging or a special offer during the subscription cancellation flow. It can be configured in App Store Connect or through a new Retention Messaging API, and is coming this fall.
When does Retention Messaging ship?
This fall, per Apple's WWDC 2026 guide. It is available both in App Store Connect and via the Retention Messaging API.
Is Retention Messaging the same as a win-back offer?
No. Retention Messaging fires during the cancel flow, before cancellation completes. A win-back targets subscribers who have already lapsed. The two are complementary but separate.
Does Retention Messaging set my price?
No. It shows messaging or a discount on top of the base price you already set per country. A save offer only works if that base price was localized to begin with.
Further reading
- WWDC 2026 App Store changes: the complete developer referenceEvery WWDC 2026 App Store change for developers, in plain English with ship dates: cross-developer bundles, group purchases, volume deals, and more.
- Apple just gave you three new ways to sell. All three still break at the border.WWDC 2026 added App Store Bundles, group purchases, and volume deals. None of them localize your price, and bundles make it worse.