Developer Console
Sign In
Sign In
Developer Console

Set Up Tiered Subscriptions in Developer Console

To use tiered subscriptions in your project, you must first manually create subscriptions, tiers, and terms in the Developer Console as in-app items. To make the items available in your app, enter data about these items one at a time in the Developer Console, and then submit each subscription. You can update your in-app items at any time.

Add new tiered subscription

If you already have a published app and you would like to add tiered subscriptions to it, you must submit a new version of this existing app. Your new app version must integrate the Appstore SDK that supports tiered subscriptions. If you don't already have an existing app, you can create a new app in the Developer Console.

To create a new tiered subscription in the Developer Console

  1. Sign in to your developer account in the Developer Console, then select Apps & Services > My Apps.

  2. Click the title of your app.

  3. On the left sidebar, click In-App Items.

  4. Click Add Single IAP, and then Add a Subscription.

    Clicking 'Add Single IAP' opens a menu with the option 'Add a Subscription'.

  5. Enter a Subscription Title, a Subscription SKU, and click Add Subscription.

    Create new subscription dialog. Fields: Subscription Title and Subscription SKU. Buttons: Cancel and Add Subscription.

Your subscription details are ready now.

Base subscription details with subscription title and SKU.

Add description and images

The Display Title and Description (for English, US) are mandatory fields. For multilingual support, you might also want to enter translations of the Display Title and the Description.

  1. Under Description & Images, add a Display Title and a Description for English (US).

    Description & Images section

  2. (Optional) Click Update localization.

  3. (Optional) Use the checkboxes to select every language that you localize your app into (and for which you submit a localized app file).

    Update localization dialog

  4. (Optional) Click Update localization.

    You can now see new tabs for all the chosen languages.

    Each added language has its own tab.

  5. (Optional) Enter a Display Title and a Description for every language.

    Each language tab contains fields for display title and description.

  6. (Optional) For every language you support, drag your icons and drop them under the Icon section.

Add tiers

Every subscription forms a group of one or more tiers. For example, you can offer a Gold, a Silver, and a Bronze tier to your customers as part of the same subscription.

Initially, there is a No tier added indication under the Description & Images section.

To add tiers

  1. Click Add New Tier.

  2. Enter a Tier Title, a Tier SKU, and click Create tier.

    Create new tier dialog. Fields: Tier Title, Tier SKU. Buttons: Cancel, Create Tier.

    Your Tier Details should look like this:

    Tier details view contains tier title and tier SKU.

  3. (Optional) Under Tier Description & Images, click Add translation, and use the checkboxes to select every alternative language supported by your app.

  4. (Optional) Enter Display Title, Description, and upload icons for every language.

    Upload 512 x 512 px and 114 x 114 px icons.

  5. Repeat steps 1-4 to add additional tiers linked to your subscription.

Add subscription terms

You must create new terms for your tiers. Every tier must have at least one term.

For example, under your Gold tier, you can add new WEEKLY and MONTHLY terms. Terms belonging to different tiers need different SKUs, even if these terms have the same duration. For example, Silver Monthly and Gold Monthly term SKUs are not the same.

  1. Select your tier. For example, click Gold.

  2. Under Subscription terms, click Add New Term.

  3. Choose a Term Period, enter a Term SKU, and click Create Term.

    Create new term dialog. Fields: Term Period, Term SKU. Buttons: Cancel, Create Term.

  4. Set up pricing for your term. For a free trial, select the Yes option under Free Trial, and choose the duration of the trial.

    Set base price and prices for each marketplace.

  5. Repeat steps 1-4 for all terms of every tier you have, such as MONTHLY, ANNUALLY, and so on.

    After you set pricing for all the terms, the Submit IAP button at the top of the screen, becomes active.

  6. Click Submit IAP.

    Submit IAP button

Last updated: Apr 07, 2025