Set up offer codes

1. From Apps, select your app.

2. In the sidebar, click Subscriptions.

3. Choose the subscription group containing your subscription.

4. Select the subscription from the list.

5. In the Subscription Prices section, click the add button (+).

6. From the menu, click Create Offer Codes.

7. Enter a reference name for the offer. You’ll use this reference name to manage the offer in App Store Connect and to identify sales associated with offers in Sales and Trends reports and StoreKit transactions.

8. Select the customer eligibility for your offer. You can select one or more of the following:

   • New subscribers: Customers who have never subscribed to any subscription product within the group.

   • Existing subscribers: Customers who are currently subscribed to a product within the group.

   • Expired subscribers: Customers who were previously subscribed to a product within the group, but whose subscription has expired.

9. 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. Eligible customers will redeem your app’s introductory offer first, then automatically renew to the offer they redeemed with the code.

   • No. Eligible customers 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.

10. Click Next.

11. Select the countries or regions where you want to make your offer available, then click Next.

12. Choose Pay as you go, Pay up front, or Free.

13. Choose the appropriate duration, and if applicable, the discounted price for a base country or region, then click Next. To search from a larger list of price points, click See Additional Prices.

    App Store Connect provides comparable prices for all 175 App Store countries and regions, taking into account taxes and foreign exchange rates. If you want to set different prices for specific storefronts, make the changes and click Next.

14. Make sure the details of your offer are correct and click Confirm.

    Note: Once you create an offer, you won’t be able to edit it. If changes to customer eligibility are needed, create a new offer.

In order for customers to redeem codes, your app must be in the Ready for Sale state.

1. From Apps, select your app.

2. In the sidebar, click subscriptions.

3. Choose the subscription group containing your subscription.

4. Click the subscription, then go to the Subscription Prices section and click View all Subscription Pricing.

5. In the menu bar, click Offer Codes.

6. Select your offer from the list.

7. Click the “Create One-Time Use Codes” button.

8. In the pop-up window, select the number of codes you want to create.

   You must select a minimum of 500 and a maximum of 25,000. If you need more than 25,000 codes, you can create multiple batches of codes for the same offer.

9. Choose an expiration date to determine how long the codes are valid. One-time use codes can be valid for a maximum of six months. Codes expire at 12:00 a.m. PT on the expiration date.

10. Click Create. It may take up to an hour before codes are redeemable by customers.

Once your one-time use codes are created, you’ll need to download them from App Store Connect so you can share them.

1. From Apps, select your app.

2. In the sidebar, click subscriptions.

3. Choose the subscription group containing your subscription.

4. Click the subscription, then go to the Subscription Prices section and click View all Subscription Pricing.

5. In the menu bar, click Offer Codes.

6. Locate your offer in the list and click the reference name.

7. Locate the codes you want to download and click Download.

8. Open the extracted text (.csv) file in a spreadsheet application.

Once you’ve created custom codes, you won’t be able to edit them. Custom codes can’t be used for other offer campaigns or subscriptions for the app. To create a custom code that's already being used by a different offer for the same app, you must first deactivate the code.

1. From Apps, select your app.

2. In the sidebar, click subscriptions.

3. Choose the subscription group containing your subscription.

4. Click the subscription, then go to the Subscription Prices section and click View all Subscription Pricing.

5. In the menu bar, click Offer Codes.

6. Select the offer from the list.

7. Click the “Create Custom Codes” button.

8. Enter a custom code up to 64 characters and without any special characters.

9. Choose a redemption limit. This is the total number of people who can redeem this custom code. You can choose a limit of up to 25,000 at a time. If you need more, use the same custom code multiple times for the same offer.

10. Choose an expiration date to determine how long the codes will be valid (with a maximum of 6 months for codes with an expiration date). Codes expire at 12:00 a.m. PT on the expiration date.

    To create codes with no expiration date, choose No End Date from the date picker. Expiration dates can't be edited.

11. Click Create. It may take up to an hour before codes are redeemable by customers.

You're responsible for distributing offer codes to your customers. You can utilize your own channels, such as email or offline marketing campaigns.

• Give codes to customers directly: Codes can be shared through online or offline channels. For example, you might print the codes on cards that you give out at an event. People can redeem one-time use codes by entering them in the “Redeem Gift Card or Code” page in their App Store account settings, or redeem custom codes within your app if you’ve implemented the appropriate StoreKit method. Learn more.

• Create a unique redemption URL: Codes can be used to create redemption URLs that you can share directly. When someone visits the URL, they'll land on a page where they can redeem your code. People who haven't installed your app will first be prompted to download the app before redeeming the code.

  To create these URLs for one-time use codes, copy the example link from your offer details page, then add each code to the end of the URL. One-time use code URLs are also included in the downloadable text file.

1. From Apps, select your app.

2. In the sidebar, click subscriptions.

3. Choose the subscription group containing your subscription.

4. Click a subscription, then go to the Subscription Prices section and click View all Subscription Pricing.

5. In the menu bar, click Offer Codes.

6. Click the reference name of the offer.

7. Locate the codes you want to deactivate and click Deactivate.

8. Click Deactivate again to proceed

   The codes will expire immediately. Subscribers who have already redeemed the codes won’t be affected. Unredeemed codes will also expire and will not be reapplied to the 1,000,000 quarterly limit.

You can have up to 10 active offers per subscription SKU at a time in App Store Connect. If you wish to deactivate an offer, please note that the offer can't be reactivated later. All codes associated with the offer will be invalidated. Subscribers who have already redeemed codes for the offer won't be affected.

1. From Apps, select your app.

2. In the sidebar, click subscriptions.

3. Choose the subscription group containing your subscription.

4. Click a subscription, then go to the Subscription Prices section and click View all Subscription Pricing.

5. In the menu bar, click Offer Codes.

6. Click the reference name of the offer.

7. In the upper corner, click Deactivate.

   You can view your deactivated offers anytime, as well as download expired codes associated with deactivated offers.