​
Prerequisites

Before continuing, make sure you have:

​
Configure entitlements

1

Create premium entitlement

  1. In Superwall dashboard, go to Products in the left sidebar
  2. Select Entitlements in the top menu
  3. Click + Add Entitlement
  4. Identifier: Enter premium
  5. Click Create
This entitlement will be used by both iOS and Android products to identify premium status.

​
Configure products

1

Gather product information

Reference the product IDs you created in the iOS Products guide.
Ensure your product IDs are 100% correct and match exactly what’s in App Store Connect. Also verify your products have a valid status (either Ready to Submit, Approved, or Published). Products in Missing Metadata state cannot be tested.
2

Add monthly and yearly subscriptions

  1. In Superwall dashboard, go to Products > Products
  2. For each subscription type (Monthly, Yearly, or Yearly with Trial):
  • Click + Add Product
  • Product ID: Paste the subscription ID from App Store Connect (following the pattern from the iOS Products guide)
  • Trial: (Optional) Default is “None” - or choose a period (e.g., “1 week”)
    • If trial selected: Trial Price appears → Default is “Free” or set a price
  • Price: Set to match the price in App Store Connect
  • Period: Select Month for monthly or Year for yearly subscription
  • Entitlements: Select premium for all subscription types
  • Click Save

​
Configure example paywall

1

Edit the example paywall

  1. In the left sidebar, click Paywalls
  2. Click on the Example Paywall that is provided as an example for the new project
  3. This will open the Paywall Editor
  4. Choose Products in the left sidebar
  5. Click on primary and pick the yearly subscription product
  6. Pick the monthly subscription product for the secondary product
  7. Delete the tertiary product (you can remove it entirely)
You have now added your products to a paywall.
2

Enable feature gating

  1. In the paywall editor’s left sidebar, pick Settings
  2. Find Feature Gating and switch it to Gated
  3. Press Publish in the top right corner
Your example paywall is now ready.
3

Configure example campaign

  1. Go back to Superwall dashboard
  2. In the left sidebar, pick Campaigns
  3. Click the Example Campaign that is also provided as an example for your new project
  4. You will see that you have 1 Paywall, which is the “Example Paywall” we edited just now
4

Create custom placement

  1. Click the + symbol next to Placements on the left
  2. You’ll see some placements provided by default, but we want to make our own
  3. Where it says Select…, type out onboarding_complete
  4. Click Add Placement
Great! Now you can make it so that this paywall shows right after the user finishes their onboarding flow after installing and launching the app for the first time.
Your Superwall configuration for iOS is now complete. You can test your paywall and subscription flow in your app.

​
Next steps

After completing product configuration:
  • Test your paywall in your iOS app using sandbox testing
  • Customize your paywall design and messaging in the Superwall dashboard
  • Set up additional campaigns and placements as needed for your app’s user flow