How to tier subscriptions in a local StoreKit configuration file

A step by step guide on creating local auto-renewable subscriptions with subscription levels that allow users to upgrade or downgrade service using XCode.

Oscar de la Hera Gomez
Written by Oscar de la Hera Gomez
First published on 02/21/2023 at 13:36
Last Updated on 02/21/2023 at 19:49
Two flowers that represent StoreKit and Xcode side by side, beneath them sits the text "Local Tiered Subscriptions."

A step by step guide on creating local auto-renewable subscriptions with subscription levels that allow users to upgrade or downgrade service using XCode.

Subscribe

If you are looking to do this on App Store Connect, which is required for release on the App Store, consult the tutorial below.

How to tier subscriptions in App Store Connect

Step One: Select the StoreKit Configuration File

A screenshot of Xcode showing a newly created local Storekit file.

Select the local StoreKit configuration file.

If you have yet to create one, follow the tutorial below.

How to setup StoreKit in XCode

Step Two: Create the Auto-Renewable Subscriptions

A screenshot of the modal that Xcode shows when trying to create a local auto-rewenable subscription. The screenshot demonstrates that you can either add a new auto-renewable subscription to an existing group, or create a new subscription group to which it will be added.

Create the Auto-Renewable Subscriptions and make sure that they fall within the same Subscriptions Group.

For a tutorial on how to do so, consult the one below.

How to create a local StoreKit Subscription in Xcode.

Step Three: Tier the subscriptions

A screenshot of a Subscription Group selected in a local StoreKit Configuration File in Xcode. Highlighted are the numbers under "Level" that allow you to set the Subscription level.

Select the subscription group for the subscriptions and then give each subscription a level using the dropdown next to each subscription id.

Please note that Level 1 is the highest level, and 2 would be a lower level (and so on, and so forth).

"Arrange your subscriptions in descending order, starting with the option that offers the highest level of service. You can add more than one subscription to each level. This order will determine your subscription's upgrade and downgrade options."

-

Apple

Please note that Xcode will automatically reorder your subscriptions to show hierarchy, as demonstrated below.

A screenshot of a subscription group with a sample subscription being level 1 and a tier 2 subscription being level 2. The sample is above the tier 2 in the hierarchy.
A screenshot of a subscription group with a sample subscription being level 2 and a tier 2 subscription being level 1. The tier 2 is above the sample in the hierarchy. This demonstrates that it reorders the list based on levels.

Any Questions?

We are actively looking for feedback on how to improve this resource. Please send us a note to inquiries@delasign.com with any thoughts or feedback you may have.
SubscribeContact UsVisit our BlogView our ServicesView our Work

Partner with us

We would love to get to know you and see how we can help your organization with its goals and needs.
Let's Talk

Stay Informed

Get occasional updates about our company, research, and product launches.
Subscribe