Set up App Store Connect Products

8 min

First, log in to App Store Connect, which is Apple's central hub for managing your apps. This guide assumes you have an app already set up and are ready to add in-app purchases.

Important: Complete Your Agreements First!

Before you can create or test any in-app purchases, you must have your business agreements in order.

  1. Sign the Paid Applications Agreement: Navigate to the Agreements, Tax, and Banking section. Ensure the 'Paid Applications' agreement shows an 'Active' status. You will not be able to test purchases until the latest version is signed.
  2. Complete Tax and Banking Info: In the same section, go through the "Tax" and "Banking" tabs. You must link a bank account and have its status be "Clear" before you can proceed.

Signing all agreements is required to continue.

Create an In-App Purchase

In App Store Connect, navigate to My Apps and select your application. In the sidebar, select Subscriptions under the "Features" section.

My Apps in App Store Connect Selecting Subscriptions

If you're creating a one-time purchase (like a non-consumable), select In-App Purchases instead. The steps are very similar.

1. Create a Subscription Group

Subscription Groups organize your products so users can easily switch between them (e.g., upgrading from a monthly to an annual plan). If you don't have one yet, you'll be prompted to create one.

Click the '+' symbol to create a Subscription Group. You'll need to provide a Reference Name. This is not shown to users, so use something descriptive for your own reference (e.g., "Pro Tier Subscriptions").

Creating a subscription group

2. Add a New Subscription Product

After creating your Subscription Group, click the '+' symbol next to its name to add a new subscription product.

You'll be asked to provide a Reference Name and a Product ID.

Adding a new product
  • Reference Name: This is for your internal use in App Store Connect and reports. It won't be displayed to users. Use a human-readable name like "Pro Plan - Annual".
  • Product ID: This is a crucial, unique identifier for your product. It can never be used again, even if you delete the product. We highly recommend a consistent naming scheme.
Pro Tip: Product ID Naming Convention
A good format is <app>_<price>_<duration>_<intro>.
For example, a $39.99/year subscription with a 1-week free trial could be: rc_3999_1y_1wfree. This makes it easy to identify products at a glance.

3. Set Subscription Duration and Price

Once the product is created, set the subscription Duration from the dropdown menu (e.g., '1 Year').

Next, in the Subscription Prices section, click the '+' icon to add a price. Choose your primary currency and price, and Apple will automatically calculate prices for all other regions.

Setting subscription price

At the last step, remember to Save your changes.

4. Add Introductory Offers (Optional)

To add a free trial or introductory price, click the Introductory Offers tab. Click the '+' icon to configure it. You can set the countries, duration, and type of offer (e.g., Free, Pay as you go). For a simple free trial, select Free and choose the duration.

Configuring free trials

At the last step, remember to Save your changes.

5. Add Localization and Reviewer Information

Finally, you need to provide the customer-facing details and information for Apple's review team.

  • Localization: Under App Store Information, add a localization. Provide a Subscription Display Name and Description. This is what users will see.
  • Reviewer Information: You must upload a Screenshot of your paywall (a placeholder is fine during development) and can add optional Review Notes. Your app cannot be submitted for review without this screenshot.
Pro Tip: For all products that unlock the same level of access (e.g., monthly and annual "Pro" plans), use the exact same Subscription Display Name. This creates a cleaner and less confusing experience for users in the App Store.

Once you've finished setting up your products on App Store Connect, you're all set!