App Store Connect Help

Support / App Store Connect / Manage subscriptions / Set up offer codes

Manage subscriptions

Set up offer codes

If you offer auto-renewable subscriptions on the App Store, you can set up offer codes to provide people with a free or discounted price for a specific duration and help you acquire, retain, and win back subscribers. You can create codes for a maximum of 1 million redemptions per app, per quarter.

There are two types of offer codes:

One-time-use codes

  • Unique, one-time-use codes that customers redeem through a redemption URL, by entering the code in the App Store code redemption flow, or within your app.

  • Redeemable by customers within your app if they’re using a device running iOS 14, iPadOS 14, or macOS 15, or later and your app supports the appropriate StoreKit method. Learn more.

  • Useful for small-scale distribution or when code access needs to be restricted.

  • Expire after a maximum of six months from the date they’re created.

Custom codes

  • Uniquely named custom codes — for example, SPRINGPROMO — that customers redeem through a redemption URL or within your app.

  • Redeemable by customers within your app if they’re using a device running iOS 14, iPadOS 14, or macOS 15, or later and your app supports the appropriate StoreKit method. Learn more.

  • Ideal for large campaigns that require mass distribution.

  • Optionally set a maximum redemption limit and/or expiration date.

Customer eligibility is determined by you in App Store Connect and can include customers with new, active, and expired subscriptions. Consider your offer’s eligibility requirements before creating and distributing offer codes.

Learn about offer types and which one to choose.

Get business guidance for auto-renewable subscriptions.

Configure offer codes

Learn how to provide offer codes using the App Store Connect API.

Required role: Account Holder, Admin, App Manager, or Marketing. View role permissions.