
Apple replaced legacy promo codes with Offer Codes. This step-by-step guide shows you exactly how to generate Offer Codes in App Store Connect, understand the limits, and distribute them to users without losing them to bots.
Since Apple retired legacy IAP Promo Codes in March 2026, Offer Codes are now the standard way to give users free or discounted access to your paid apps, subscriptions, and in-app purchases.
If you're new to Offer Codes — or if you're coming from the old promo code system — this guide walks you through everything: what they are, how to generate them, the limits you need to know, and how to distribute them without losing them to bots.
Offer Codes are one-time-use codes you generate in App Store Connect that give users:
They work for:
They do not work for consumable IAPs (like coin packs in games).
| Feature | Legacy Promo Codes (Retired) | Offer Codes (Current) | |---------|-------------------------------|----------------------| | Status | Retired March 2026 | Active | | Max per quarter | 100 per app version | 1,000,000 per offer | | Type | App/IAP access | Subscriptions + one-time purchases | | Redemption | Alphanumeric code | Code or direct URL | | Custom codes | No | Yes ("SUMMER2026") | | Eligibility targeting | None | New, existing, or lapsed users |
The big upgrade: you can now generate up to 1 million codes per offer per quarter, and you can create "Custom Codes" — a single code like "WWDC2026" that many users can claim, up to a limit you set.
Before you start, you need:
You'll be asked to fill in:
Offer Reference Name — An internal label (not visible to users). Example: "March 2026 Launch Promo"
Offer Type — Choose from:
Duration — How long the offer lasts. Example: 3 months at $0.
Eligibility — Who can claim this offer:
Territories — Which App Store regions the code works in. If you're running a global giveaway, select all territories. Note: codes generated for one territory cannot be redeemed in another.
Once your offer is configured and approved (usually instant for price-change offers), you can generate codes.
One-Time Use Codes:
Custom Codes (Multi-Use):
Custom Codes are great for sharing on social media, at conferences, or in videos — but they're also more vulnerable to abuse (one person can share the code anywhere). Use them when exposure is intentional.
You have several distribution options:
Option A: Redemption URLs (Recommended)
Instead of sharing a raw alphanumeric string, share a direct URL:
https://apps.apple.com/redeem?ctx=offercodes&id=[APP_APPLE_ID]&code=[YOUR_CODE]
When a user taps this link, the App Store opens directly to the redemption screen. Much smoother than asking users to navigate to Settings → App Store → Redeem Code.
Option B: Manual Distribution
Share codes individually via email or DM. Fine for small quantities (under 20), but doesn't scale.
Option C: Automated Queue Distribution
For 50+ codes, use a dedicated distribution platform. Upload your CSV of one-time codes, share a single public URL, and the system:
This is the approach used by developers running serious giveaway campaigns.
Quarterly limits: Each product has a pool of 1,000,000 one-time-use codes per calendar quarter. If you distribute more aggressively, you can exhaust this pool.
Territory restrictions: Codes generated for "United States" don't work for users with UK App Store accounts. If you have a global user base, generate codes for each major territory separately.
Expiry dates: All codes must have an expiry date. Apple doesn't allow "no expiry." Plan your campaigns with the 6-month maximum in mind.
Eligible products: Offer Codes work with Auto-Renewable Subscriptions and Non-Renewing Subscriptions. For paid apps (one-time purchase), you can still use the legacy "Promo Codes" system under the app-level settings — this is separate from IAP Offer Codes and was not retired.
Redemption reporting: You can see redemption counts in App Store Connect under Analytics → Sources. Look for "Offer Codes" as a traffic source.
The main reason developers run Offer Code giveaways is to generate reviews. Don't forget the follow-up:
https://apps.apple.com/app/id[APPLE_ID]?action=write-reviewThis follow-up step is where most developers drop the ball. The code gets claimed but no review appears — because no one asked.
Running a large Offer Code giveaway? Promo Code Queue was built for exactly this — upload your CSV, share one link, and get automated email capture, bot protection, and analytics.
Marketing expert and growth strategist

Learn how strategic promo code campaigns drive real download velocity, improve App Store rankings, and create lasting momentum for your app's growth.

Apple is officially retiring legacy Promo Codes for In-App Purchases on March 26, 2026. Learn how this affects your app marketing and how to transition to the more powerful Offer Codes system.

App Store reviews directly drive your search ranking and conversion rate. This step-by-step framework shows you how to systematically generate more 5-star reviews without violating Apple's guidelines.