​
Prerequisites

Before creating iOS subscription products, make sure you have:
  • Completed the App Store Connect Setup for your app
  • Signed Paid Applications Agreement in App Store Connect
  • Completed tax and banking information in App Store Connect

​
Create In-App Purchase Subscriptions

1

Verify Agreements and Banking

Before setting up products, ensure you have:
  • Paid Applications Agreement: Latest version signed in the “Business” module in App Store Connect
  • Tax and Banking: Complete forms in the “Tax” and “Banking” tabs
  • Bank Account: Linked with “Clear” status
You cannot test in-app purchases until these requirements are met.
2

Create Subscription Group

  1. Select your app from the list in App Store Connect
  2. Under Monetization, select Subscriptions
  3. Under “Subscription Groups”, click Create
  4. Reference name: Give it a name (e.g., “Premium Subscriptions”)

​
Add Localization

  1. Click Add Localization
  2. Language: Select your default language (e.g., English)
  3. Display Name: Use the same name as Reference name (e.g., “Premium Subscriptions”)
  4. Click Add
3

Create Subscription Products

Under “Subscriptions” in your subscription group, click Create.

​
Product Configuration

  • Reference Name: Internal name for App Store Connect reports (not visible to users), max 64 characters
  • Product ID: Unique identifier used in development and with Superwall
Important: Once used, Product IDs can never be reused across any app, even if deleted.Recommended format: <app>_<entitlement>_<duration>_<trial>Examples:
  • Yearly subscription with no trial: bwai_premium_1y
  • Monthly subscription with no trial: bwai_premium_1m
  • Yearly subscription with 1 week trial: bwai_premium_1y_1w

​
Subscription Details

  1. Subscription duration: Pick the duration (e.g., 1 year)
  2. Availability:
    • Make available in at least one country/region (your region)
    • Or select All in the top right corner
    • Click Done
4

Configure Pricing

  1. Subscription Prices: Click Add Subscription Price
  2. Country or Region: Select your default currency (e.g., United States (USD))
  3. Price: Select your price (only specific prices ending in “.99” are available)
  4. Click Next
  5. Keep the automatically generated prices and click Next
  6. Click Confirm to confirm the prices
5

Add Localization

  1. Click Add Localization
  2. Language: Select your default language (e.g., English)
  3. Display Name: Give it a concise name (e.g., “Premium”)
  4. Description: Add a description (e.g., “Unlimited access to all features”)
  5. Click Add
Use consistent Display Names across all products that provide the same access level for better user experience.
6

Add Reviewer Information

Add required reviewer information for submission:
  • Screenshot: Required (640 x 920 px) - You can download our placeholder image for testing; for final submission, use your actual paywall screenshot
  • Review Notes: Optional - Add clarifications about your purchase
7

Save Your Product

Click Save to finish setting up your subscription product.Your subscription product should show status as Ready to submit, which means you can now add it to your app!

​
Adding Trial Periods (Optional)

1

Create Subscription with Trial

To add a trial period to your subscription:
  1. Create a new subscription product following the steps above
  2. Use a product ID that includes the trial duration (e.g., bwai_premium_1y_1w for yearly with 1 week trial)
2

Configure Introductory Offer

Inside your subscription product:
  1. Under “Subscription Prices”, click + > Create Introductory Offer
  2. Countries or Regions: Select All and click Next
  3. Start/End Date:
    • Start Date: Select today
    • End Date: No End Date
    • Click Next
  4. Type of Introductory Offer:
    • Select Free
    • Duration: Pick your trial duration (e.g., 1 week)
    • Click Next
  5. Click Confirm to confirm the introductory offer

​
Additional Resources