OOmnistu

Blog / Monetization

Monetization

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.

OOmnistu
Reviewed 2026-11-19 · 3 min read

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:

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

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

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.