Apple opened retention messages to every subscription app on November 4. No closed beta, no registration, no API build required for the basic version. If you sell a subscription on the App Store, you can now put a message in front of a subscriber right as they are about to cancel. I am setting this up for Math Buddies Pro, and here is the plan.
Retention messages are the simplest win in the subscription business. You already did the hard work of getting someone to subscribe. The cancel screen is the last moment you get to make a case for staying. Until now, most indie developers could not touch that moment at all.
What we cover
- What Apple actually opened up on November 4
- What the basic version can and cannot do
- Why the API still matters, and what I am requesting
- The setup I am planning for Math Buddies Pro
- What this does not apply to
What Apple opened up
Retention messages live in App Store Connect now, and they are self-serve. You configure an image and a short text that shows on the confirm cancellation screen, plus an offer for the subscription. When a subscriber taps cancel, they see your message before the cancellation goes through.
The example Apple shows is a fitness app telling a canceling subscriber about a guided yoga feature launching next month, with an offer of 2.99 for three months before the regular price resumes. The pattern is the same whatever your app does: remind them what is coming, and give them a reason to stay that costs you less than losing them.
There are limits worth knowing. You can have up to 10 messages per app, one per subscription at a time. The text cannot mention prices or discounts. Each message goes through App Review, so it is not instant.
What the basic version can and cannot do
The basic version is one message per subscription, shown to everyone who cancels. That is already a big step up from nothing, and it is the version I am starting with. It costs nothing extra and it needs no code.
What it cannot do is target. You cannot show one message to a subscriber who has been around for a year and a different one to someone who subscribed last week. You cannot run an experiment to see which message keeps more people. And the offers are per subscription, not per segment of users.
That is the honest limit of the free tier. It will keep some subscribers, and it will do it with almost no work. It will not tell you which message works best, because it only lets you run one.
Why the API still matters
For targeting and experiments, Apple still wants you to request access to the Retention Messaging API. That is the route to per-segment messages, specific offers like discounts or plan switches for particular groups of users, and real experiments on what actually retains people.
RevenueCat has a Retention Messaging feature built on that API, and it handles the configuration, the offers, and the experiments. I already use RevenueCat, so that is the path I am looking at for the next step. The basic version in App Store Connect is step one. The API is step two, once I know the basic message works.
The setup I am planning for Math Buddies Pro
Math Buddies Pro is the subscription this is for. The app is free to start, with Pro unlocking the full set of lessons and modes. A parent canceling Pro is usually not angry. They are tidying up subscriptions, or their kid had a busy month. The message should speak to that.
My plan is to lead with what is coming next in the app, not with a discount. New trails, new buddies, and new modes are the reason to stay, and parents who already like the app respond to what is next more than to a price cut. The offer is there as a second step, for the subscribers who need a nudge rather than a reminder.
I have not written the final message yet. That is still an open draft, and it deserves a real pass rather than a rushed one. The point of this post is that the setup is possible now, not that I have finished it.
What this does not apply to
PocketMacro is a one-time purchase, 4.99 once, no subscription. There is nothing to retain there, and retention messages do not apply. Crazy Thoughts has a subscription, so it qualifies, but Math Buddies Pro is first because it has the larger subscriber base and the clearer story about what is coming next.
Final thoughts
The cancel screen used to be a dead end. Now it is a conversation. If you have a subscription app and you have not set up a retention message yet, open App Store Connect and do the basic version today. It takes an afternoon, and it is the cheapest retention work you will ever do.
The short version: the basic message is free, self-serve, and live now. Set it up first, then request the API when you are ready to test what actually works.
