Store mechanicsUpdated Jun 2026

Retention Messaging

Alsoretention messagingretention messaging apicancellation flow offersubscription save offercancel flow messaging

Retention Messaging is an App Store Connect tool and API for the subscription cancel flow. Announced at WWDC 2026, coming this fall, it shows custom messaging or a special offer as a subscriber moves to cancel.

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

Sources