App Store Connect In-App Purchase Setup: A Step-by-Step Guide

Setting up in-app purchases (IAPs) in App Store Connect can feel like navigating a maze, especially with different types and various fields to fill. I've been there, and I know how frustrating it is when a single misconfiguration holds up your app update.

This guide will walk you through exactly how to set up in-app purchases in App Store Connect, covering consumable, non-consumable, auto-renewable, and non-renewing subscriptions. By the end, you'll have a clear understanding of each field and how to avoid common pitfalls, so your IAPs are ready for App Review.

Before You Start: App Record and Agreements

You can't add in-app purchases without an existing app record in App Store Connect. If your app isn't already listed under "My Apps," you'll need to create one first, even if it's just a placeholder. Ensure you have at least the initial app version created.

Crucially, you must have the "Paid Applications Agreement" active. This agreement covers the terms for selling paid apps and in-app purchases. If it's not active, you won't be able to add or manage IAPs. Check its status by navigating to App Store Connect, then "Agreements, Tax, and Banking," and finally "Agreements." The status for "Paid Applications Agreement" should be "Active." If it's "Pending" or "Contact Us," you'll need to resolve that first.

Understanding In-App Purchase Types and Their Use Cases

Apple offers four distinct types of in-app purchases, each designed for different monetization strategies. Choosing the right one is fundamental before you begin configuration.

Let's consider a hypothetical habit tracker app to illustrate each type:

Consumable In-App Purchases

Consumables are items that are purchased, used up, and can be bought again. These are best for features like game currency, extra lives, or temporary boosts.

• Example: In a habit tracker, a "Streak Freeze" token might be a consumable. Users buy it to prevent their habit streak from breaking if they miss a day, and they can buy more whenever they run out.
• Key characteristic: Users can purchase them multiple times. Your app is responsible for tracking consumption.

Non-Consumable In-App Purchases

Non-consumables are purchased once and provide permanent access to content or features. These don't expire or get used up.

• Example: "Unlock Pro Features" for the habit tracker, which might include custom themes, unlimited habit slots, or advanced analytics. Once purchased, these features are permanently unlocked for the user.
• Key characteristic: Purchased once, lasts forever. Apple handles the restoration of these purchases if a user reinstalls your app.

Auto-Renewable Subscriptions

These provide access to content or services for a specific duration and automatically renew until the user cancels. They require a "Subscription Group" in App Store Connect.

• Example: A "Premium Subscription" for the habit tracker, offering cloud sync, exclusive challenges, and priority support for a monthly or yearly fee.
• Key characteristic: Automatic renewal. Users benefit from continuous access. Essential for recurring revenue models.

Non-Renewing Subscriptions

These offer access for a fixed period, but do not automatically renew. The user must manually purchase again once the subscription expires. This type is less common now, often replaced by auto-renewable subscriptions or consumables.

• Example: A "3-Month Accountability Coaching Pack" that grants access to a specific coaching module and content for a limited 90-day period, after which the user would need to buy it again.
• Key characteristic: Fixed duration, no automatic renewal.

Step-by-Step: Adding Your In-App Purchase in App Store Connect

Now that you understand the types, let's go through the process of adding an IAP.

1. Navigate to Your App:
   • Log in to App Store Connect.
   • Click "My Apps."
   • Select the app you want to add IAPs to.
2. Access In-App Purchases:
   • In the left sidebar, click on "Features," then "In-App Purchases."
   • Click the blue "+" button next to "In-App Purchases" to add a new one.
3. Choose Your Type:
   • Select the type of in-app purchase you want to create (Consumable, Non-Consumable, Auto-Renewable Subscription, or Non-Renewing Subscription). Click "Create."
4. Configure Basic Information:
   • Reference Name: This is for your internal use only, maximum 64 characters. Make it descriptive (e.g., Streak Freeze Token, Pro Features Unlock).
   • Product ID: This must be a unique identifier for your IAP, typically in a reverse-domain name format (e.g., com.yourcompany.yourapp.productid). This ID must exactly match the one you use in your app's code. It cannot be changed after creation.
5. Set Pricing:
   • Choose a price tier from the dropdown menu. Apple provides a fixed set of price points. This is the price your users will see on the App Store.
   • For auto-renewable subscriptions, you'll also define subscription durations (e.g., 1 month, 1 year) and their respective prices.
6. Add Localizations:
   • Click "Add Localization."
   • For each language your app supports (or at least your primary language), you need to provide:
     • Display Name: This is the name users see in your app and on the App Store (maximum 30 characters).
     • Description: A brief explanation of what the IAP offers (maximum 45 characters).
7. Provide Review Information:
   • Screenshot: Upload a screenshot that clearly shows the in-app purchase in action within your app. This image is for App Review only, not for users. The recommended dimensions are 640x920 pixels or 920x640 pixels, in JPG or PNG format. It should demonstrate the IAP's value or how it appears in your UI.
   • Review Notes: Provide clear, step-by-step instructions on how the App Review team can find and test this specific in-app purchase in your app. Include any necessary credentials if your IAP requires a login.
8. Specifics for Auto-Renewable Subscriptions:
   • Subscription Group: If you don't have one, click "Create New" under "Subscription Group." A group allows users to switch between different subscription tiers within the same app, e.g., monthly vs. yearly, or basic vs. premium. Users can only be subscribed to one product within a group at a time.
   • Family Sharing: You can enable or disable Family Sharing for the subscription.
   • Introductory Offers: Set up free trials, pay-as-you-go, or pay-up-front options to entice new subscribers.
   • Offer Codes: Configure unique, redeemable codes for promotional purposes.
9. Save Your Changes:
   • Once all required fields are filled, click "Save." The IAP status should change to "Ready to Submit."

Common In-App Purchase Configuration Errors

Even with a step-by-step guide, it's easy to stumble into common traps. Here are some of the frequent issues I've seen:

• Product ID Mismatch: The Product ID in App Store Connect must exactly match the string literal you use in your app's code, including case. Any difference will prevent your app from finding the IAP.
• Missing Agreements: As mentioned, if the "Paid Applications Agreement" isn't "Active," your IAPs won't be available for sale.
• Inadequate Review Information: Forgetting the review screenshot or providing vague review notes is a fast track to App Review rejection. The screenshot needs to clearly depict the IAP.
• Incorrect Subscription Group Setup: Auto-renewable subscriptions *must* belong to a subscription group. If you have multiple tiers (e.g., "Basic" and "Premium" monthly), they should be in the same group to manage upgrades/downgrades properly.
• Localization Gaps: If your app supports multiple languages, ensure your IAP's Display Name and Description are localized for each. Missing localizations can cause issues in specific App Store regions.
• Product Not Cleared for Sale: Even if an IAP is "Approved," it won't be visible to users until it's linked to an approved app version and that version is released. Check the "App Store" tab for your app version to ensure IAPs are included.

Checklist: Before Submitting Your App with New IAPs

Use this quick checklist to ensure everything is in order before you hit that submit button:

• [ ] Your "Paid Applications Agreement" status is "Active" in App Store Connect.
• [ ] All required in-app purchases are created in App Store Connect.
• [ ] The Product ID for each IAP in App Store Connect exactly matches the one in your app's code.
• [ ] Each IAP has a clear, concise, and localized "Display Name" (max 30 characters) and "Description" (max 45 characters).
• [ ] You've uploaded a high-quality review screenshot for each IAP, ideally 640x920 or 920x640 pixels, showing the IAP in context.
• [ ] Your "Review Notes" provide simple, clear, step-by-step instructions on how the App Review team can access and test each IAP.
• [ ] For Auto-Renewable Subscriptions, a "Subscription Group" is correctly configured, and any introductory offers or offer codes are set up as needed.
• [ ] You have thoroughly tested purchases using Sandbox testers to confirm they work end-to-end.
• [ ] Your app's Xcode project includes the In-App Purchase capability.

FAQ

Why is my In-App Purchase status "Missing Metadata"?

This status usually means you haven't completed all the required fields. The most common culprits are missing review screenshots, review notes, or localizations for the display name and description. Double-check all tabs within the IAP configuration page.

Can I delete an In-App Purchase after creating it?

You can delete an IAP only if it has never been submitted for review or approved. Once an IAP has been approved, you can only remove it from sale, disable it, or stop promoting it. This preserves historical transaction data.

What is a Subscription Group, and why do I need one?

A Subscription Group links related auto-renewable subscriptions within your app. Users can only subscribe to one product within a group at a time. This is essential for managing upgrades, downgrades, and cross-grades between different subscription tiers (e.g., monthly vs. yearly, basic vs. premium) without requiring users to cancel and resubscribe.

How long does it take for In-App Purchases to be approved?

If you submit new IAPs with a new app version, they are reviewed concurrently with that version. If you submit IAPs independently (e.g., adding a new IAP to an existing live app), the review process is typically similar to an app update, usually within 24-48 hours. Ensure your review information is clear to speed up the process.

Do I need a screenshot for every localization of my In-App Purchase?

No, you only need one review screenshot per in-app purchase, regardless of how many languages you localize the display name and description into. The screenshot should be clear enough to convey the IAP's purpose without relying heavily on text, or you can use an English version.

Next Steps: Showcasing Your In-App Purchases

Once your in-app purchases are configured and approved, don't forget to highlight them. Ensure your App Store screenshots effectively communicate the value of your premium features or subscription benefits. A strong App Store description can also articulate what users gain from your IAPs. Making your IAPs visible and desirable is key to conversion.