Providing Promo Codes

Provide potential customers or reviewers with a free copy of your iOS, tvOS, or Mac app by using promo codes. Promo codes can be redeemed through any store territory where your app is available and are valid for four weeks from the day they’re generated. Each promo code generated for an app can be used one time to download the app.

Requesting Promo Codes

You can request up to 100 promo codes for every version of each platform of your app, or for your in-app purchases.

With in-app purchase promo codes, users can download your app (if the price of the app set to free) and redeem the code for the in-app purchase item. Codes can even be used before your app is available on the App Store. You can provide up to 100 promo codes for each in-app purchase item, with a limit of 1,000 total in-app purchase codes per app every six months (resetting on January 1 and July 1). These codes are for non-commercial use and expire 28 days after they were requested.

To request promo codes for an app version, the version’s status must be Ready for Sale or Pending Developer Release. For in-app purchases, the state must be Approved or it won't appear as an option.

An iTunes Connect user with the Admin or Marketer role can request promo codes. If the Promo Codes page isn’t available to you, you don’t have the correct role to request promo codes.

To request promo codes

  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click My Apps.

    ../Art/MyAppsIcon_2x.png
  3. Open the App Details page for the app, as described in Creating an iTunes Connect Record for an App.

  4. Click Features.

  5. Click Promo Codes.

  6. Next to the version and platform of the app, select the number of promo codes you want to receive. Type in the number of version or in-app purchase promo codes you want to generate.

  7. Click Generate Code.

    ../Art/PromoCodes_Step7.shot/Resources/shot_2x.png../Art/PromoCodes_Step7.shot/Resources/shot_2x.png
  8. Read and agree to the contract terms for Apple to distribute free versions of your app or in-app purchase and click Generate Code.

  9. You can copy and paste the codes from the screen, or download a .txt file.

  10. Click Done.

    ../Art/PromoCodes_Step10.shot/Resources/shot_2x.png../Art/PromoCodes_Step10.shot/Resources/shot_2x.png

You can see the history of the codes downloaded by going to the History section under Promo Codes.

../Art/19A-RequestPromoCodeHistory_2x.png../Art/19A-RequestPromoCodeHistory_2x.png

How to Use Promo Codes

You can distribute the promo codes by email or other means. The user enters the promo code when purchasing the app.

When a customer downloads an app using a promo code, the app behaves just as it would if it had been purchased. For example, the customer has the opportunity to update to new versions of the app. However, customers aren’t able to rate or review an app that was downloaded using an iTunes Connect promo code.

App promo codes apply to a specific app version, so when users redeem promo codes for a version of an app that hasn’t been released yet, they download the prerelease version. The app will start downloading if the customer is redeeming an app promo code. For in-app purchase promo codes, the app will automatically download if the app is free and not currently installed on the customer's device. If the app is paid, customers will need to download the app in order to redeem the in-app purchase.

Promo codes for tvOS or multi-platform apps must be redeemed through the App Store on a desktop or iOS device. After the code has been redeemed, the tvOS app will appear in the customer’s purchase history on the Apple TV App Store.

Viewing Promo Code Transactions

You can view a history of your promo code requests by clicking View History on the Promo Codes page. The history shows the time and date for each set of codes generated in iTunes Connect. Use this history to determine the expiration date of your codes.

If an app is purchased using a promo code, the purchase will be indicated in your Sales and Trends reports. You can learn more about the the information available to you in the Sale and Trends Guide.

Managing Promo Code Issues

If users report that they have received an error when attempting to download your app using an iTunes Connect promo code, direct them to iTunes Support. By doing so, users can resolve their store account issue directly.