Apple retention messages: what subscription apps can now show when users cancel

On November 4, 2026, Apple made retention messages available for auto-renewable subscriptions. When a subscriber starts to cancel, the cancellation flow can now show a message from the developer. It can be plain text, text with an image, or text with a retention offer.

For subscription apps this is a new place to win back revenue that was about to leave, and it sits outside your app and your store listing. It is also tightly controlled by App Review, so the details of what you can and cannot write matter before you ship anything.

What Apple launched

According to Apple's developer news post, retention messages remind subscribers of the value of a subscription while they decide whether to cancel. You set them up in App Store Connect for your auto-renewable subscriptions, including which subscribers are eligible and how long to wait between offers. MacRumors reported the same launch.

A separate Retention Messaging API lets a developer choose which message to show each subscriber based on their subscription details. Apple says access to that API is available by request, so most small teams will start with App Store Connect alone.

The three versions of a message

Every message needs a header and body text. What the subscriber sees depends on what you attach and whether they qualify, according to Apple's help page.

Offers can be pay as you go, pay up front or free, each with a duration and price. You choose the territories, set a price for a default territory, and App Store Connect calculates the others from current exchange rates. You can override any of them.

Limits to plan around

• Up to 10 retention messages per app. Deleting one is permanent.
• A message can cover any number of subscriptions, but each subscription can have only one message at a time. Adding a subscription to a new message removes it from the old one.
• Up to 10 retention offers per subscription billing plan type, and one message can include all 10.
• Images must be 3840 by 2160 or 5244 by 2950 pixels.
• Editing a live message creates a draft. The live version stays until the draft is approved, and there is no rollback to an earlier version.
• Account Holder, Admin, App Manager and Marketing roles can configure messages.

Eligibility has two controls: how long someone must have held a paid subscription, and how long they must wait before redeeming the same offer again. The wait applies per offer, so a subscriber can still be shown a different offer on the same subscription.

Copy rules that decide whether you pass review

This is where most first attempts will fail. Apple's help page says the header and body text must not mention offers, discounts or prices, with examples such as a dollar amount, 50% off or one month free. App Review rejects messages that do. The offer itself is shown by Apple next to your text, so the copy should explain value, not price.

Factual statements about what the subscriber loses are allowed. Apple gives the example of losing access to downloaded content when the subscription ends. Coercive or unverifiable claims are strongly discouraged, including superlatives like the best app and unsupported statistics. Use standard capitalization and punctuation, and avoid all-caps text and repeated exclamation marks.

Add a localization for every language you support, and include one for every storefront where the subscription is sold. The default is your app's primary language, so a subscriber in another market could otherwise see text that does not match their language.

How much can it save?

Treat any headline number with care. PPC Land reported that an Apple WWDC26 session cited an average save-rate gain of 1.4 percentage points for retention messages, and 5.5 points for messages with promotional offers. By the same report, Apple did not disclose the sample size, the period or whether the comparison was controlled, and this article could not verify the session itself.

The useful reading is modest: a small share of people who reach the cancellation page will change their mind. Even so, on a subscription with steady churn, a point or two of saves compounds across every renewal cycle. Whether an offer is worth giving depends on your margin and on whether the subscriber would have paid full price anyway.

What to do now

1. List your auto-renewable subscriptions and your main reasons for cancellation from your own data.
2. Draft one message per subscription group with a true, specific value statement and no mention of price.
3. Create at least one retention offer for subscriptions with the highest churn, and set territories and prices deliberately.
4. Add localizations for every storefront you sell in.
5. Use the preview tool in App Store Connect, including the ineligible-subscriber view, and test in sandbox.
6. Submit for review and expect a rejection or two on copy. Fix the wording and resubmit.
7. Compare churn, trial conversion and revenue per subscriber for a few billing cycles before and after you launch.

Apple says the offer identifier lets you track sales in Sales and Trends reports and in StoreKit transactions, so tag your offers clearly. If you want churn, trial conversion and revenue from App Store Connect and RevenueCat on one screen to judge the change, App Traction's performance analytics pulls those from your own connected accounts.

Sources

• Apple Developer News: Now available: Retention messages for subscriptions
• Apple: Configure retention messages in App Store Connect
• MacRumors: Apps Can Now Try to Stop You From Canceling Subscriptions
• PPC Land: Apple lets apps offer discounts to subscribers who try to cancel