This guide will walk you through the process of setting up Apple subscription plans for purchase in your iOS app.
1. Create a subscription group
đ§ Skip this step if you already have a subscription group. Do not create multiple subscription groups.
Sign into App Store Connect and select your app.
Click âSubscriptionsâ in the left menu.
Click âCreateâ under âSubscription Groupsâ and give the group whatever reference name you like. This name will not be public.
Click âCreateâ under âApp Store Localizationâ and give the subscription group a display name. This will be shown to your users next to the name of their subscription plan, so choose something that would make sense (e.g. âPaid Subscriptionâ, âPremium Subscriptionâ, etc.)
2. Add a subscription plan
Select your subscription group and click the blue plus icon next to âSubscriptionsâ to add a new subscription plan. Fill the fields in as follows:
Reference Name: The name of the plan as you would like it to appear in your admin dashboard. This name will not be public.
Product ID: The product ID can be anything you like, but itâs standard to use your domain name reversed and qualified. For example if your domain name is
myapp.mycompany.comyou might usecom.mycompany.myapp.monthlyfor your monthly subscription.
Fill out the following fields on the page for your new subscription:
Subscription Duration: Choose how often the subscription should renew. Treefort supports subscription terms of 1 month or more. Weekly subscriptions are not supported.
Availability*: Click âSetup Up Availabilityâ and choose the regions where you would like your subscription to be sold.
Subscription Prices
Click the âAdd Subscription Priceâ button and choose your home region and price. Click âNextâ.
Review the regional prices that Apple automatically calculates for you. Click âNextâ again and then âConfirmâ.
App Store Localization: Click âAdd Localizationâ. Enter the name and description of your plan as you would like them to appear when users checkout.
Review information**
Take a portrait screenshot of the homepage of your mobile app. A screenshot of the preview under the âAppâ tab will work fine. Make sure that you only include the app interface in the screenshot (e.g. do not include your entire admin dashboard). Resize the screenshot to exactly
1284 x 2778(a little stretching of the original image fine).Upload the screenshot under âScreenshotâ.
Paste the following under âReview Notesâ: âTap the account icon in the top left of the app and then tap Subscribeâ. For non-English apps, translate only the word âSubscribeâ into your appâs default language.
Click âSaveâ
*Availability: Unless you need to limit the reach of your app we recommend leaving all regions selected except for âChina mainlandâ under "Asia Pacificâ. Apple requires a license from the Chinese Communist Party in order to publish in that region.
**Review information: You can re-use the same screenshot and notes for all subscriptions. If you have trouble with this process do not hesitate to reach out to us for help. Weâre aware that Appleâs requirements here are a bit tricky.
3. Import your plan in the admin dashboard
Click "App Store" in the "Subscription plans" card in the Monetization tab in your admin dashboard and use the import dropdown in the top right of the card to import the plan you just created. The newly imported plan won't be available in the app until you click the row for the plan and use the "Visibility" card to mark it as published. You'll also need to use the "Offerings" card to associate the plan with an offering to make it available in the app.