Providing Promo Codes

Provide potential customers or reviewers with a free copy of your iOS or Mac app by using promo codes. Promo codes can be redeemed through any store territory where your app is available and are good for four weeks from the day they’re generated. They become invalid if a new version of the app becomes available or if your contract with Apple expires. 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. To request promo codes for an app version, the version’s status must be Ready for Sale or Pending Developer Release.

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.

  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.

  7. Click Generate Code.

  8. Read and agree to the contract terms for Apple to distribute free versions of your app and click Generate Code.

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

  10. Click Done.


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


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. Promo codes don’t work for in-app purchase products, including issues for apps in the Magazines & Newspapers category.

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.

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.

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.

When apps are purchased using promo codes, the promo code is included in earnings reports and sales reports for the transaction.

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.