> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encorekit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Subscription Product

> Connect your Google Play catalog and pick the subscription Encore offers.

## Overview

Now that you've set up placements, choose the subscription product Encore offers. When a user accepts a win-back offer, Encore triggers a real Google Play subscription purchase using the product you select here. Google Play handles all entitlement state — no custom entitlement tracking code is needed in your app.

The fastest path is to **connect your Google Play catalog** so Encore auto-syncs your subscriptions (and their offers) and you pick one from a dropdown — no typing Product IDs by hand. This happens in the **Entitlements** step (labelled **Connect store**) of the Integration Progress tracker.

<Info>
  Connect your Google Play service account once, then pick your subscription from the auto-synced list. Manual Product ID entry is still available as a fallback if you don't connect a credential.
</Info>

***

## Connect Your Google Play Catalog (Recommended)

<Steps>
  <Step title="Upload your Google Play service account">
    In your app's **Entitlements** step, upload your Google Play service-account **JSON** file. Encore verifies it with Google and reads your catalog.

    See [Connect Your Store Credentials](/publishers/connect-store-credentials#android-google-play-service-account) for the full walkthrough, including the three required permissions (**View app information (read-only)**, **View financial data**, **Manage store presence**).
  </Step>

  <Step title="Pick your subscription, base plan, and offer">
    Once the catalog syncs, the **Subscription product** section shows a picker. Work top-down — pick your subscription, then (if it has more than one base plan) the base plan, then the offer:

    1. **Subscription** — choose the product that gates entitlements.
    2. **Base plan** — a Google Play subscription can expose several base plans (e.g. monthly, annual, a seasonal 12-month plan) at different prices. The base plan you pick determines the **price and billing period** the user sees and is charged.
    3. **Offer** — within the chosen base plan, pick the **offer** (e.g. a free trial) users see at purchase. Choose **No offer** to charge the base plan immediately.

    <Note>
      The base-plan step only appears for Play subscriptions that expose more than one base plan — single-base-plan products skip straight to the offer. iOS has no base plans (each subscription is its own product), so this step doesn't apply there either.
    </Note>
  </Step>

  <Step title="Don't have a product yet? Let Encore create one">
    If you don't already have a suitable subscription, Encore can pre-fill a recommended annual product (priced from your existing catalog, with a free trial) and **create it in Google Play Console for you** — base plan, price, and trial offer included. Review the fields, confirm, and Encore writes the subscription, then promote it to **ACTIVE** in Play Console when you're ready.
  </Step>
</Steps>

<Note>
  Newly created products land in your Play Console catalog as a draft. Review the auto-filled base plan, price, and trial offer, then activate both the base plan and the subscription — products in **Draft** state cannot be purchased.
</Note>

***

## Manual Product ID Entry (Fallback)

If you haven't connected a store credential, you can still enter a Product ID by hand. Create the subscription yourself in Google Play Console, then enter its details in the Encore Dashboard.

<Steps>
  <Step title="Create the subscription in Google Play Console">
    Go to [play.google.com/console](https://play.google.com/console) → your app → **Monetize → Subscriptions** → **Create subscription**.

    | Field            | Value                                        |
    | ---------------- | -------------------------------------------- |
    | **Product Type** | Subscription (auto-renewing)                 |
    | **Product ID**   | `{your.package.name}.encore.annual.1m.trial` |
    | **Base Plan**    | 1 Year, auto-renewing                        |
    | **Offer**        | Free Trial, 1 Month                          |

    Add a base plan with your billing period and pricing, add a **Free trial** offer, then **Activate** both the base plan and the subscription. Products in "Draft" state cannot be purchased.

    <Warning>
      The **Product ID** and **Base Plan ID** cannot be changed or reused after creation.
    </Warning>
  </Step>

  <Step title="Enter the details in Encore">
    In your app's **Entitlements** step, type the **Product ID** (e.g. `com.yourapp.encore.annual.1m.trial`) and, if you want a specific trial, the optional **Offer ID** (e.g. `intro-7d-trial`) into the fallback inputs and save.
  </Step>
</Steps>

The SDK automatically reads the configured Product ID from Encore and uses it when presenting offers.

***

## Next Steps

* [Configure Analytics](./configure-analytics) - Set up Google Play Real-Time Developer Notifications to track subscription events