How to create local offer codes for subscriptions in Store Kit

A step by step guide on creating offer codes for for an auto-renewable subscription in a local StoreKit configuration file in XCode.

Oscar de la Hera Gomez
Written by Oscar de la Hera Gomez
First published on 02/20/2023 at 11:22
Last Updated on 02/20/2023 at 12:14
A flower that represents App Store Connect next to one that represents Xcode. Beneath it sits the text "Local Offer Codes."

A step by step guide on creating offer codes for for an auto-renewable subscription in a local StoreKit configuration file in XCode.

SubscribeRead Apple's documentation on Offer Codes

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: Select or Create the Auto-Renewable Subscription

A screenshot of Xcode of an Auto Renewable Subscription in a Store Kit Configuration File with the details discussed in this tutorial filled in.

Select the Auto-Renewable Subscription in the StoreKit Configuration File.

If you have not created on yet, follow the tutorial below.

How to create a local StoreKit Subscription in XCode

Step Three: Click +

A screenshot of Xcode showing a local StoreKit Configuration File with an Auto Renewable subscription selected. Highlighted is a + icon, which acts as a button, under the "Offer Codes" section.

Under Offer Codes, click +.

Step Four: Complete Details

A screenshot of the create Offer Code modal that appears in XCode, highlighting the details that are described below.

In the Configure Offer for Codes modal:

  • Give the offer code a reference name
  • Set the offer type (Free, Pay as you go, Pay upfront)
  • Set the duration (1 month, 2 months, 3 months, 6 months, 1 year)
  • Set the price (Only on Pay as you go or Pay upfront)
  • Set the eligibility (i.e. who can have access to this offer code)

Finally, set the Introductory Offers option to either Redeem Introductory Offer and Offer Code or Only Redeem Offer Code. Apple Describes these functionality as:

"If your subscription has an introductory offer, determine whether people redeeming your codes should be eligible to redeem both a code and the introductory offer by choosing from the following options:

  • Yes (Redeem Introductory Offer). New users will redeem your app’s introductory offer first, then automatically renew to the offer they redeemed with the code.
  • No (Only Redeem Offer Code). New users will redeem the offer code first, then automatically renew to the standard subscription price without using the introductory offer. If they cancel and resubscribe at any point, they’re still eligible to redeem an introductory offer."
Learn more about offer codes

Once everything looks good, click Done.

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