How to tier subscriptions in a local StoreKit configuration file

Oscar de la Hera Gomez
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.

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

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.

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.

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).

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 with any thoughts or feedback you may have.
delasign logo

Book a Free Consultation.

An icon of an email.

Click here to email us.

Fill in the details below to book a free consultation or to let us know about something else. Whatever it is, we are here to help.

How can we help you ?

Contact Details