100 per version · 28 days to use them

Promo Code Tracker

App Store Connect tells you when a batch of promo codes was generated. It does not tell you who you gave each one to, or which ones are about to lapse unused. Keep that here — the codes never leave your browser.

Never offer a promo code in exchange for a review

This is the page where the temptation arrives, so it is said here first. Giving a code away is fine — that is what codes are for. Attaching a condition to it, asking for a rating, a review, a vote or a chart-affecting action in return, is not, and Apple describes the consequence in its own words below.

Participating in the App Store requires integrity and a commitment to building and maintaining customer trust. Manipulating any element of the App Store customer experience such as charts, search, reviews, or referrals to your app erodes customer trust and is not permitted.

— Apple, App Review Guidelines, 5.6.3 Discovery Fraud

If we find that you have attempted to manipulate reviews, inflate your chart rankings with paid, incentivized, filtered, or fake feedback, or engage with third-party services to do so on your behalf, we will take steps to preserve the integrity of the App Store, which may include expelling you from the Apple Developer Program.

— Apple, App Review Guidelines, preamble to section 3 (Business). Note the placement: that sentence is not numbered, it sits in the preamble to section 3, immediately before 3.1 Payments.

Repeated manipulative or misleading behavior or other fraudulent conduct will lead to your removal from the Apple Developer Program.

— Apple, App Review Guidelines, 5.6 Developer Code of Conduct

There is also a mechanical reason it cannot work even if you wanted it to. Apple states that a customer who downloaded an app with a promo code can’t rate or review the app — so a code handed over in exchange for a review buys a review the recipient is not able to leave. Send codes so people can try the thing. Ask for nothing back. Read the guidelines

A promo code is single-use value — whoever reads it first gets the app. Everything you type here is stored in this browser and nowhere else. This page makes no network requests of any kind, there is no account, no sync and deliberately no share link. The CSV export writes to your own disk; the copy button redacts the codes, because clipboards end up in group chats.

Your batches

One batch per set of codes you generated. The generation date is the one on the History tab in App Store Connect — the four-week window runs from there, not from the day you sent a code, so a batch generated early is already burning through its window.

Nothing tracked yet. Add the batch you generated in App Store Connect.

What Apple documents

All of it from Apple’s own help page, read on 2026-08-25. Nothing here was filled in from memory, and anything Apple does not state is not stated below.

  • 100 per version, per platform

    Apple: "You can request up to 100 promo codes per version of each platform your app supports." Ship a new version and a new allowance comes with it; the allowance is not a yearly or per-app budget.

  • Four weeks, from generation

    Apple: "Each code remains valid for four weeks from its generation date and can be used only once." The clock starts when App Store Connect made the code, not when you sent it — so generating a batch early spends the window on your own desk.

  • App Store Connect holds the real dates

    The Promo Codes History tab shows the date each set of codes was generated, and Apple says to use that date to work out when they expire. That table is authoritative; this page is your copy of it.

  • Redeemable in any storefront you sell in

    Apple: these codes "can be redeemed on any App Store storefront where your app is available" — so a code works for a reviewer abroad, as long as the app is on sale there.

  • iOS, macOS and tvOS

    Apple describes promo codes as giving "a free copy of apps on iOS, macOS, or tvOS", and adds that codes for tvOS or multi-platform apps must be redeemed on an iOS device, after which the tvOS app appears in the customer’s purchase history on the App Store for Apple TV.

  • The app behaves as if it were bought

    Apple: "When a customer downloads an app using a promo code, the app functions as if it were purchased" — including getting future updates. Promo codes can also redeem unreleased versions of apps already on the App Store.

  • They cannot rate or review it

    Apple states plainly that a customer who downloaded via a promo code "can’t rate or review the app". Anyone planning to trade codes for App Store reviews should read that sentence twice — it does not work, and asking is separately against the rules.

  • Redemptions land in Sales and Trends

    Apple: "Purchases made using promo codes are indicated in your Sales and Trends reports." That is where you find out whether a code was used. This page cannot see it — nothing here talks to App Store Connect.

  • Two cases where codes will not work

    Apple notes promo codes cannot be generated for apps available only on Apple Business or Apple School Manager, and that if your app has been removed from sale on all storefronts they can be neither generated nor redeemed.

  • Account Holder, Admin, App Manager or Marketing

    The roles Apple lists as able to request promo codes. If the Promo Codes item is missing from your sidebar, that is usually why.

Giving away an in-app purchase is a different thing

Promo codes give away the app. If what you want to hand out is a subscription or an in-app purchase, that is offer codes, and every limit on this page stops applying.

  • •Offer codes are for in-app purchases and subscriptions, not for the app itself. They are created per in-app purchase or per subscription, not per version.
  • •Apple documents up to 10 active offers at a time, and codes for a maximum of 1 million redemptions per app, per quarter.
  • •One-time-use codes are created in batches of 500 to 25,000 and must carry an expiry, up to a maximum of six months. Apple states they "expire at 12:00 a.m. PT on the expiration date".
  • •Custom codes are names you choose, redeemable by many customers up to a limit you set, with an optional expiry of up to six months or no end date at all.
  • •None of those numbers apply to the promo codes tracked on this page, and the four-week window here does not apply to them.

Apple’s pages: offer codes for in-app purchases and offer codes for subscriptions.

The 100-per-version allowance, the four-week window and every other rule above were read from Apple’s Request and manage promo codes on 2026-08-25, and the quoted guideline text from the App Review Guidelines the same day.

Some things are deliberately absent because Apple does not publish them. There is no per-app or per-year code total — Apple documents the allowance per version, per platform, and nothing else. There is no separate figure for in-app purchase promo codes, because the current help section documents app codes only. Apple draws no distinction between free and paid apps on that page, so none is asserted here either way. And generating a batch means agreeing to a contract that is not a public page, so read that rather than assuming what it allows.

Expiry is computed as 28 days from the generation date you entered. Apple gives the window as four weeks and publishes no time of day for the cutoff, so the last day is approximate — do not cut it fine. App Store Connect’s History tab is the authority on when a batch was actually generated.

Every status on this page is one you set. Nothing here can see whether a code was redeemed; Apple reports redemptions in Sales and Trends. There are no redemption statistics, no benchmark and no recommended number of codes to send, because none of those are published anywhere and inventing them would be worse than the spreadsheet this replaces.

Working out who to send them to? The launch directory lists 30 venues, the launch post writer drafts the pitch, and campaign links tag the link so App Analytics can tell the venues apart.

Which promo code went to whom, and how long has it got left?

Apple gives you up to 100 promo codes per version of each platform your app supports, and each one is valid for four weeks from the day it was generated. App Store Connect will tell you when a batch was created and let you download the codes. It will not tell you who you gave each one to, which venue they came from, or which codes are about to lapse having never been opened.

That gap is normally filled by a spreadsheet nobody maintains. This is that spreadsheet, with Apple’s documented allowance counted for you and the four-week clock running on every batch. Everything stays in your browser — a promo code is single-use value, so nothing here is uploaded, synced or shareable.

How it works

  1. 1Add a batch for each set of codes you generated, with the platform, the app version, and the generation date from the History tab in App Store Connect.
  2. 2The expiry countdown runs from that generation date, not from the day you sent a code. Apple’s window is four weeks from generation, so a batch created two weeks before launch reaches its reviewers with half its life gone.
  3. 3Add a row per code: the code, who it went to, the venue you found them at, the date you sent it, and whether it has been used. Venue autocompletes from the 30 places listed on the launch directory.
  4. 4Allowance is counted per version and platform — Apple’s own unit — and summed across every batch filed against the same version, so two batches for one version cannot quietly total more than 100 without being flagged.
  5. 5Export the full ledger as CSV, or copy a summary with the codes redacted for pasting somewhere less private.

What it cannot tell you

  • It cannot see whether a code was redeemed. No public API exposes a promo code’s state; Apple reports redemptions in Sales and Trends. Every status on this page is one you set by hand, and the page says so rather than dressing your own bookkeeping up as a measurement.
  • There are no redemption statistics, no benchmark and no recommended number of codes to send. Nobody publishes what share of promo codes get used, by venue or otherwise, so nothing here estimates one.
  • Apple documents the four-week window but no time of day for the cutoff, so the final day is approximate. Treat a code on its last day as already gone.
  • The allowance shown is what you entered, not what Apple issued. App Store Connect is the authority on that.
  • Handing someone a code in exchange for a review breaks the App Review Guidelines, and Apple states that a customer who redeemed a promo code cannot rate or review the app anyway. Nothing on this page will help you trade codes for ratings.
  • Promo codes give away the app itself. Giving away a subscription or an in-app purchase is offer codes, which have entirely different limits — none of the numbers here apply to them.

Frequently asked questions

How many App Store promo codes do I get?

Apple documents up to 100 promo codes per version of each platform your app supports. It is not a per-app or per-year budget — shipping a new version brings a new allowance. Apple publishes no other total, so no other total is stated here.

When do App Store promo codes expire?

Apple states that each code remains valid for four weeks from its generation date and can be used only once. The clock starts when App Store Connect created the code, not when you sent it, so generating a batch early spends part of the window before anyone receives it. The History tab in App Store Connect shows each batch’s generation date.

Can I give someone a promo code in exchange for a review?

No. Apple’s guidelines forbid manipulating reviews, and the preamble to section 3 says attempting it may result in expulsion from the Apple Developer Program. It also cannot work mechanically: Apple states that a customer who downloaded an app using a promo code can’t rate or review it. Send codes so people can try the app, and ask for nothing in return.

Do promo codes work in other countries?

Apple states that promo codes can be redeemed on any App Store storefront where your app is available, so a reviewer abroad can use one as long as you sell there.

Can I use promo codes to give away a subscription or in-app purchase?

No — promo codes give away the app itself. Subscriptions and in-app purchases use offer codes, which are created per in-app purchase or subscription and carry their own separate limits, including a maximum expiry of six months rather than four weeks.

Are my codes uploaded anywhere?

No. This page makes no network requests of any kind. Everything is stored in your browser’s local storage, there is no account and no sync, and there is deliberately no share link. The CSV export writes to your own disk; the copy-summary button leaves the codes out.