Configure Entitlements

Overview

Encore presents win-back offers to users who signal exit intent (e.g., tapping “Cancel Subscription”). When a user accepts, Encore triggers a real App Store subscription purchase using a product you configure here. The App Store handles all entitlement state — no custom entitlement tracking code is needed in your app.

You need to create a subscription product in App Store Connect and enter its Product ID in the Encore Dashboard. Choose the method that works best for you below.

Create Your IAP Product

Encore CLI (Recommended)
Manual Setup

The fastest way to create and configure your subscription product. The CLI walks you through interactive prompts and creates everything in App Store Connect automatically.

npx @encorekit/iap-setup setup-iap

Requires Node.js v18+. Your App Store Connect credentials stay local and are never sent to Encore.

The CLI will:

Authenticate with your App Store Connect API key
Create a subscription group and product with the recommended configuration
Set up pricing and a free trial introductory offer
Output the Product ID for you to enter in the Encore Dashboard

Create the subscription product yourself in App Store Connect.

Recommended Configuration

Field	Value
Product Type	Auto-renewable subscription
Reference Name	Encore Annual 1 Month Trial
Subscription Duration	1 Year
Introductory Offer	Free Trial, 1 Month
Product ID	`{your.bundle.id}.encore.annual.1m.trial`

Steps

Open App Store Connect

Go to appstoreconnect.apple.com and navigate to Your App → Subscriptions.

Create a Subscription Group

If you don’t already have one, create a new Subscription Group (e.g., “Premium Access”).

Create Subscription

Click ”+” to add a new subscription. Enter:

Reference Name: Encore Annual 1 Month Trial
Product ID: {your.bundle.id}.encore.annual.1m.trial

Then click Create.

Set Subscription Duration

In the subscription editor, set Subscription Duration to 1 Year.

Set Availability

Under Availability, select all countries where you want the subscription available.

Save Changes

Click Save in the top right corner.

Set Up Pricing & Introductory Offer

Click the blue ”+” next to Subscription Prices, then select “Introductory Offer”:

Countries: All Countries
Start Date: Today, no end date
Type: Free
Duration: 1 Month
Click Confirm

Set Up Localization

Add localization for your subscription:

Display Name: 1 Month Free Trial
Description: Unlock all premium features

Add Review Information

At the bottom of the page, add Review Information with a screenshot of your current paywall.

Save & Submit

Save your changes and submit the subscription for review.

Subscriptions can be approved independently of app updates.

Enter Product ID in Dashboard

Once your product is created:

Go to your app in the Encore Dashboard
Navigate to Entitlements
Paste your Product ID (e.g., com.yourapp.encore.annual.1m.trial)
Confirm: “I have created this product in App Store Connect”
Click Save

The SDK will automatically read this Product ID from the Encore configuration and use it when presenting offers.

Next Steps

Install the SDK - Add Encore to your project
Configure the SDK - Initialize Encore with your API key
Present Offers - Show win-back offers at the right moment

Getting Started

iOS SDK

Web SDK

Configure Entitlements

Overview

Create Your IAP Product

Recommended Configuration

Steps

Enter Product ID in Dashboard

Next Steps

Getting Started

iOS SDK

Web SDK

​Overview

​Create Your IAP Product

​Recommended Configuration

​Steps

​Enter Product ID in Dashboard

​Next Steps

Overview

Create Your IAP Product

Recommended Configuration

Steps

Enter Product ID in Dashboard

Next Steps