Originally published on AppRanker.
App Store offer codes are now the only way to hand out a free or discounted In-App Purchase on iOS. Since March 26, 2026, App Store Connect no longer lets you create promo codes for In-App Purchases, so any launch, press or win-back flow built on them is broken. Here is what replaces them, the limits that bite, the StoreKit code you need, and the Google Play equivalent.
What changed and what still works
Apple announced the change on October 29, 2025. Offer codes now cover every purchase type: consumables, non-consumables, non-renewing subscriptions and auto-renewable subscriptions. Old In-App Purchase promo codes can still be redeemed until they expire, and promo codes still exist for one thing: a free download of the app itself.
| App promo codes | Offer codes | |
|---|---|---|
| Gives | Free app download | Free or discounted IAP or subscription |
| Volume | Up to 100 per version per platform | Up to 1M one-time-use plus 1M custom per app, per quarter |
| Validity | 4 weeks | Up to 6 months; custom codes can have no end date |
| Eligibility rules | None | By purchase history or subscription status |
One catch for early-user campaigns: customers who redeem an app promo code cannot rate or review the app.
Pick the right code type
| One-time-use | Custom | Sandbox | |
|---|---|---|---|
| Use it for | Contest winners, event attendees, reviewers | A newsletter or partner with one memorable code like SPRING26
|
Testing redemption |
| Size | 500 to 25,000 per batch | 1 code, up to 25,000 redemptions | 10 to 10,000 |
| Expiry | Required, up to 6 months | Optional, up to 6 months, or none | Optional |
| Redeem via | URL, App Store, or in-app | URL or in-app | Sandbox account settings |
Limits worth knowing before you click anything:
- Each app gets up to 10 active offers at a time, and each customer can redeem one code per offer.
- Offers cannot be edited. Wrong eligibility or price means a new offer.
- Unredeemed codes from a deactivated batch do not return to your quarterly limit. Size batches to the campaign, not to the maximum.
- Codes expire at 12:00 a.m. Pacific Time on the expiry date, and new codes can take up to an hour to work.
- Subscription codes work from iOS 14.2. Codes for consumables, non-consumables and non-renewing subscriptions need iOS 16.3 or later.
Eligibility is where offer codes beat promo codes. For an In-App Purchase you choose from: never purchased, purchased in the last 30 days, purchased more than 30 days ago. For subscriptions you choose new, existing or expired subscribers. Expired subscribers are your win-back audience.
Create the offer
You need the Account Holder, Admin, App Manager or Marketing role.
- Open the app in App Store Connect, then In-App Purchases and the product, and click Create Offer under Offer Codes. Subscriptions start from Subscriptions instead.
- Enter a reference name. It must be unique and cannot change, and it labels the sales in reports, so name it after the campaign.
- Set eligibility and the countries or regions.
- Choose a free or paid offer and a base price. App Store Connect suggests prices for all 175 storefronts.
- Confirm, then generate codes. One-time-use codes need the app in Ready for Distribution and come as a CSV. Custom codes take up to 64 characters, no special characters.
Subscription offers come as Free, Pay as you go or Pay up front. If you switch auto-renewal off, the offer must be free, which makes a safe thank-you for beta testers.
Share the redemption URL (the example link on the offer page plus the code) rather than the bare code. It also works as an install link for people who lack the app. Typed codes belong in places people cannot click, such as a podcast read.
Support redemption in your app
Custom codes can be redeemed without a link only through the system sheet, and Apple says not to build your own UI. In SwiftUI (iOS 16+):
Button("Redeem a code") { showRedeemSheet = true }
.offerCodeRedemption(isPresented: $showRedeemSheet) { _ in }
UIKit uses AppStore.presentOfferCodeRedeemSheet(in:). Redemption can also happen outside your app, so start a transaction listener at launch:
Task.detached {
for await update in Transaction.updates {
guard case .verified(let tx) = update else { continue }
if tx.offer?.type == .code { /* log the campaign */ }
await grantEntitlement(for: tx)
await tx.finish()
}
}
Transaction.offer needs iOS 17.2. Server-side, the decoded transaction has offerType 3 for an offer code, with offerIdentifier set. Notifications: SUBSCRIBED when a code starts or restarts a subscription, OFFER_REDEEMED for an active subscriber, ONE_TIME_CHARGE for non-subscription products.
When redemption fails
- "This promotional offer is not available." Reported in an April 2026 Apple forum thread for free one-time-use codes on a live non-consumable. They started working after about 48 to 72 hours. Generate early and redeem one yourself first.
- "The code entered is not valid" in the sandbox. Another thread reports custom codes failing in the in-app sheet while the redemption URL worked. Test both paths.
- Silent no-ops. Wrong region, or an ineligible customer. An existing subscriber cannot use a new-subscribers-only offer.
The Google Play side
Google Play still calls them promo codes. They cover paid apps, one-time products and subscription free trials of 3 to 90 days. Custom codes are subscriptions only, in-app only, for users who never subscribed, with a limit of 2,000 to 99,999 redemptions. Quotas are 500 codes per quarter for non-subscription promotions and 10,000 one-time-use codes per quarter per subscription. The link format is https://play.google.com/redeem?code= plus the code. Make sure your app picks up purchases made outside it, through the Play Billing Library listener and a purchase query at startup.
Key takeaways
- IAP promo codes ended on March 26, 2026; offer codes cover all purchase types.
- Choose one-time-use for targeted campaigns, custom for partners and newsletters.
- Offers are immutable: check eligibility, regions and price before confirming.
- Share redemption URLs, add the system redemption sheet and run
Transaction.updatesat launch. - Generate codes days ahead and test a real redemption before sending.
For the full walkthrough, including the checklist and FAQ, see the App Store offer codes guide. Codes reach people who know your app; to reach new ones, you can put your app on the AppRanker pay-to-rank app leaderboard.
Which campaign worked best for you with offer codes: win-back, press, or partner codes, and did you hit the "not available" delay?
Top comments (0)