App Store Connect Help
Set up promotional offers for auto-renewable subscriptions
Apps on the App Store with auto-renewable subscriptions can provide a discounted price for a specific duration for existing and previously subscribed customers on iOS, macOS, and tvOS. You can use these offers to help win back subscribers who canceled their subscriptions or promote an upgrade to a higher-ranked subscription at a special price. Customers can accept the offer even if they've already accepted an introductory offer.
To get started, generate keys for in-app purchases, create a promotional offer on your app's in-app purchase page for each product, and choose a duration and offer type (pay as you go, pay up front, free). You can have up to 10 active offers per subscription.
Once you've created offers in App Store Connect, use Xcode 10.2 or later to implement the StoreKit APIs to allow these offers to be accepted by customers running iOS 12.2, macOS 10.14.4, and tvOS 12.2, or later.
Note: It may take up to 1 hour for changes you make to product metadata to appear in the sandbox environment.
Get business guidance for auto-renewable subscriptions.
Learn how to set up promotional offers with the App Store Connect API.
Required role: Account Holder, Admin, App Manager, or Marketing. View role permissions.
Set up a promotional offer
-
From Apps, select your app.
-
In the sidebar, click Subscriptions.
-
Choose the subscription group containing your subscription.
-
Click the subscription, then go to the Subscription Prices section and click the add button (+).
-
Select Create Promotional Offer.
-
Enter a Promotional Offer Reference Name and a Promotional Offer Identifier, then click Next.
-
Choose Pay as you go, Pay up front, or Free, then choose the appropriate duration, country or region, and price. To search from a larger list of price points, click See Additional Prices. Click Next.
-
App Store Connect provides comparable prices for all 175 App Store countries and regions, taking into account taxes and foreign exchange rates. If you want to set different prices for specific storefronts, make the changes and click Next.
-
Make sure the details of your promotional offer are correct and click Confirm.
Edit a promotional offer
Once you create a promotional offer, only the price can be edited. To edit the duration, type, or offer code, you must create a new offer.
-
From Apps, select your app.
-
In the sidebar, click Subscriptions.
-
Choose the subscription group containing your subscription.
-
Click the subscription, then go to the Subscription Prices section and click View all Subscription Pricing.
-
Navigate to the Promotional Offers tab, where you'll find all your promotional prices listed.
-
Click the offer you'd like to edit.
-
Choose a new price from the menu, and click recalculate to view the updated price in each country or region.
-
Click Save.
Delete a promotional offer
-
From Apps, select your app.
-
In the sidebar, click Subscriptions
-
Choose the subscription group containing your subscription.
-
Click auto-renewable subscription, then go to the Subscription Prices section and click View all Subscription Pricing.
-
Click the offer you'd like to delete, then click Delete Offer.
-
Confirm your changes in the dialogue.