Retention Messaging

Set up Retention Messaging

Connect Adapty to Apple's Retention Messaging: configure it in sandbox, pass Apple's performance test, then switch to production.

Create a retention message

Create default and promo retention messages in Adapty. Write the content, add an offer or plan switch, localize it, and submit it for Apple's review.

Retention Messaging shows subscribers a custom message on the iOS Cancel Subscription screen, before they confirm a cancellation. Use it to persuade churning subscribers to stay.

The default message gives every subscriber a reason to stay. A promo message adds a concrete incentive: a discount, a free trial, or an opportunity to switch to a more fitting plan. Apple shows each subscriber the message that matches their product and language.

You create, localize, and test messages in the Adapty Dashboard. Adapty delivers them to Apple automatically, with no app release.

Retention Messaging page in the Adapty Dashboard with the messages table and Create Default and Create Message buttons

Quickstart

Before you start, you need:

Access to Apple’s Retention Messaging program.
An App Store Connect API key in Adapty.

Then:

Connect Adapty to the Retention Messaging API in sandbox mode.
Purchase one of your products in sandbox mode, so the connectivity test has a transaction to run against.
Pass Apple’s connectivity test.
Switch to production mode.
Create your production messages — first, default messages, then promo messages — and submit each for Apple’s review.