Skip to main content
Setup Apple Subscriptions
Updated over 6 months ago

App Store Connect Setup

Follow these steps to create Subscriptions for your app on App Store Connect:

  1. Log in to App Store Connect and select your app.

  2. Click on the Subscriptions menu option under the Monetization heading.

  3. Click the Create button under the Subscription Groups heading to create a new group. Apple explains Subscription Groups as follows: All subscriptions must be a part of a group. Users can only subscribe to one subscription in a group at a time, but can change to another subscription in the same group.

  4. Enter a name for the group in the popup menu and click Create.

  5. You should now be taken to a screen showing the details of the newly created Subscription Group.

  6. Create Subscriptions in the Group.

    1. Click the Create button under the Subscriptions heading to add a new subscription. Enter the following info into the popup menu that appears:

      1. Reference Name

        1. An internal name for the product. Apple explains this field as follows: The reference name will be used on App Store Connect and in Sales and Trends reports. It won't be displayed on the App Store. The name can't be longer than 64 characters.

      1. Product ID

        1. A unique ID for the product. Apple explains this field as follows: A unique alphanumeric ID that is used for reporting. After you use a Product ID for one product, it can’t be used again, even if the product is deleted.

        2. After filling out this field, note the value that you entered. You will need to enter this in the Viewcastle Admin Portal in a later step.

    2. Click the Create button in the popup menu to go to the subscription's detail screen.

      This screen allows you to configure the following properties of the subscription (fields with an asterisk are required):

      1. Availability*

        1. Choose which countries will have this Subscription available to them.

      2. Subscription Prices*

        1. Set the base currency and price for the subscription.

      3. Tax Category*

        1. This can usually be left as the default option.

      4. App Store Localization*

        1. Allows you to configure how the Subscription will be displayed to the user in the app's listing in the App Store. You can create separate entries for each language.

      5. App Store Promotion

        1. Allows you to upload a 1024x1024 image that promotes the subscription in the app's listing in the App Store. Learn more about promoting subscriptions here.

      6. Review Information

        1. Allows you to upload a supplemental screenshot and description of the subscription to better assist the reviewer when the app is submitted to Apple for review.

    3. Press the Save button at the top right of this page to finish setting up the subscription.

  7. Navigate to the previous page (the details screen for the Subscription Group).

  8. Add App Store Localizations to the Subscription Group.

  9. Navigate to the previous page (the primary Subscriptions screen).

  10. Your first subscription group should now be complete. This primary Subscriptions screen also allows you to set up Non-Renewing Subscriptions using the same steps as Auto-Renewable Subscriptions.

  11. You can also set up Billing Grace Periods on this screen.

  12. Note: The app must be resubmitted for review for the Subscription to become available to users.

Connecting the Subscription to a Product in the Admin Portal

1. Navigate to the Products menu in the Admin Portal

2. Select the relevant product from the list, or create a new product if it doesn't exist yet.

3. ​To connect the subscription to a Product in the Admin Portal, copy the subscription's Product ID (from step 6 in the previous section) into the iOS IAP SKU field in the product's edit menu. The Product ID can be found in the list of Subscriptions for the Subscription Group in App Store Connect.

4. Ensure that the Recurring toggle is turned on.

5. Click the Save button.

Did this answer your question?