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 â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 âCreateâ button under â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â.
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 the plan into Treefort
Import: Navigate to the Monetization tab in your Treefort dashboard, click âApp Storeâ under âSubscription plansâ, and then click âImportâ.
Configure: Click âOfferingsâ under the Monetization tab, click each offering the plan should unlock, and select the plan under the offeringâs âAccessâ options. See Offerings explained for help understanding offerings.
Publish: When youâre ready to start selling the plan, click it in the Treefort dashboard and select âPublishedâ under the planâs âVisibilityâ options.