Create offer codes for in-app purchases

Offer codes provide a way to acquire, retain, and win back customers by offering discounted or free access to in-app purchases. You create and manage offer codes in App Store Connect, defining the eligibility criteria for redemption. Customers can redeem offer codes through a redemption URL, or by entering the code directly in the App Store, or within your app. You can have up to 10 active offers at a time, with a limit of 1 million codes per app, per quarter.

You define the eligibility criteria for who can redeem the code, including users who:

Never purchased within your app.
Purchased within your app in the last 30 days.
Purchased within your app more than 30 days ago.

Carefully consider your offer's eligibility requirements before creating and distributing offer codes.

There are three types of offer codes available:

One-time-use codes

Unique, randomly generated codes that can each be redeemed only once.

How Customers Redeem: Customers can redeem these codes through a unique redemption URL, by manually entering the code in the App Store, or directly within your app (if your app supports it). You can set set an expiration date with a maximum of 6 months, after which the code will no longer be valid.
In-App Redemption Requirement: Redemption within your app requires the customer to be using a device running iOS 16.3, macOS 15.0, or visionOS 1.0 or later, and your app must support the appropriate StoreKit method.
Best For:
- Small-scale distribution (i.e., giving codes to individuals as a special discount, or contest winners).
- Situations where you need strict control over who can redeem the offer (i.e., a limited-quantity giveaway, codes for event attendees only, or a codes to print on a product).
- Targeted promotions with limited distribution.

Custom codes

Codes you create yourself, using a unique name (i.e., SUMMER25, VIPACCESS). Unlike one-time use codes, a custom code can be redeemed by multiple users, up to a limit you set.

How Customers Redeem: Customers can redeem these codes through a redemption URL or directly within your app (if your app supports it).
In-App Redemption Requirement: Redemption within your app requires the customer to be using a device running iOS 16.3, macOS 15.0, or visionOS 1.0 or later, and your app must support the appropriate StoreKit method.
Best For:
- Large-scale marketing campaigns (i.e., promoting a discount to all new users).
- Promotions targeted at specific customer groups (i.e., offering a special deal to users who haven't opened the app in 30 days).
- Acquiring, retaining, or winning back specific customer cohorts.

Sandbox codes

One-time use codes for testing purposes. You can test offer redemptions through your Sandbox Account settings on iOS 16.3, macOS 15.0, and visionOS 1.0 or later, and if your app supports the appropriate StoreKit method.

Best For:
- Verifying the end-to-end offer code redemption flow in your app's sandbox environment.
- Testing different offer configurations (such as price) without affecting real users or production data.
- Confirming that your app correctly handles receipt validation and entitlement granting processes for offer code redemptions.

Required role: Account Holder, Admin, App Manager, or Marketing. View role permissions.

Set up offers

From Apps, select your app.
In the sidebar, click In-App Purchases.
Scroll down to the Offers section and click Create Offer (or scroll down to the Non-Renewing Subscriptions section and click Manage, then click Create).
Enter a reference name for the offer. Use this reference name to manage the offer in App Store Connect. After you’ve created your offer, the reference name can't be changed.

Note: You can't use a reference name that has already been used for another offer in the same app.
Select the customer eligibility for your offer, based on their in-app purchase history within your app. You can select one or more of the following:
- Never purchased within your app.
- Purchased within your app in the last 30 days.
- Purchased within your app more than 30 days ago.
Selecting all of the options will make your offer available to everyone.
Click Next.
Select the countries or regions where you want to make your offer available, then click Next.
Choose Paid Offer or Free.
Choose 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.
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.

Create one-time use codes

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

From Apps, select your app.
In the sidebar, click In-App Purchases.
Choose the in-app purchase you wish to create codes for.
Scroll down to the Offers section and locate your offer in the list.
Click the reference name.
In the One-Time Use Codes section, click the Create One-Time Use Codes button.
Click the “Create One-Time Use Codes” button.
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.
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.
Click Create.

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

Download one-time use codes

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

From Apps, select your app.
In the sidebar, click In-App Purchases (or Non-renewing subscriptions).
Choose the in-app purchase you wish to create codes for.
Scroll down to the Offers section and locate your offer in the list.
Click the reference name.
Locate the codes you want to download and click Download.
Open the extracted text (.csv) file in a spreadsheet application.

Create custom codes

From Apps, select your app.
In the sidebar, click In-App Purchases.
Choose the in-app purchase you wish to create codes for.
Scroll down to the Offers section and locate your offer in the list.
Click the reference name.
Select the offer from the list.
In the Custom Codes section, click the Create Custom Codes button.
Enter a custom code up to 64 characters and without any special characters.
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.
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.
Click Create.

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

Create sandbox codes

Sandbox codes are one-time use codes for testing purposes. You can test offer redemptions through your Sandbox Account settings on iOS 16.3, macOS 15.0, and visionOS 1.0 or later, and if your app supports the required StoreKit APIs. Learn more.

From Apps, select your app.
In the sidebar, click In-App Purchases (or Non-renewing subscriptions).
Choose the in-app purchase you wish to create Sandbox codes for.
Scroll down to the Offers section and locate your offer in the list.
Click the reference name.
In the Sandbox Codes section, click the Create Sandbox Codes button.
In the pop-up window, choose the number of codes you want to create. You must select a minimum of 10 and a maximum of 10,000 codes.
Optionally, choose an expiration date to determine how long the codes are valid. Sandbox codes can be valid for a maximum of six months. Codes expire at 12:00 a.m PT on the expiration date.

Deactivate offer codes

From Apps, select your app.
In the sidebar, click In-App Purchases.
Choose the in-app purchase you wish to deactivate codes for.
Scroll down to the Offers section and locate your offer in the list.
Click the reference name.
Locate the offer you want to deactivate and click Deactivate.
Click Deactivate again to proceed.

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