User Manual

In-App Purchases & Subscriptions

Create products, set pricing tiers, configure introductory offers, and manage subscription groups.

💳 Products list — subscriptions and one-time purchases

Products section

The Products section is accessible from the App Detail view. It lists all your in-app purchases and auto-renewable subscriptions, grouped by type.

Tap any product to view its current configuration.

Creating an in-app purchase

  1. Tap the + button in the Products section header and choose In-App Purchase.
  2. Choose the purchase type: Consumable, Non-Consumable, or Non-Renewing Subscription.
  3. Enter a Reference Name (internal name, visible only to you) and a Product ID (e.g. com.example.yourapp.premium_unlock).
  4. Select a pricing tier.
  5. Add a Display Name and Description for your primary locale.
  6. Tap Create. Mainline creates the product on App Store Connect.

Creating a subscription

  1. Tap the + button and choose Auto-Renewable Subscription.
  2. Select a Subscription Group, or create a new group. Each subscription must belong to a group.
  3. Enter a Reference Name, Product ID, and Subscription Duration (weekly, monthly, 3 months, 6 months, annual).
  4. Choose a pricing tier. Mainline sets up pricing for your base territory automatically; you can add territory overrides later.
  5. Add a Display Name and optional Description for your primary locale.
  6. Tap Create.

Editing a product

Tap a product to open its detail view. You can edit:

  • Display Name and Description per locale
  • Pricing tier (base territory and overrides)
  • Introductory offer configuration (for subscriptions)

Introductory offers

For subscriptions, tap Introductory Offer to configure a free trial or discounted introductory period. You can set:

  • Offer type: Free trial, Pay as you go, or Pay up front
  • Duration and period count
  • Price (for discounted offers)

Only one introductory offer is active at a time. Changes to introductory offers take effect after ASC processes them and your app is live.

Per-territory pricing

Tap Territory Pricing on any product to override the pricing tier for individual storefronts. This is useful for markets where standard tier pricing doesn’t map well to local purchasing power.

💡
Setting up territory pricing for subscriptions

For subscriptions, territory pricing requires that the subscription's availability be confirmed first. If Mainline shows an error when you try to set territory pricing, check that the subscription is available in the relevant territory via Pricing & Availability.

Subscription group localisations

Subscription groups have their own display name and promotional content, separate from individual subscription names. Edit these by tapping a group and choosing Edit Group Localisations. Changes to group localisations cascade to all subscriptions in the group — Mainline gives you per-subscription opt-out before applying.

Common pitfalls

⚠️
Product IDs are permanent

Once a product ID is set in ASC, it cannot be changed. Choose your naming scheme carefully before creating products.

ℹ️
Subscriptions require review approval before pricing changes take effect

Pricing changes scheduled for the future work through ASC's approval workflow. Changes to a subscription's base price take effect at the next renewal cycle after approval.