Google Play Console CLI

Theme

$gpc subscriptions
--json--dry-run

Manage subscriptions, base plans, and subscription offers using the modern monetization API.

usagegpc subscriptions <subcommand> [options]

Play Billing Library deadline (client-side)

The Play Billing Library (PBL) lives in your app's code, not in GPC. GPC manages the server-side catalog (subscriptions, base plans, offers, prices) through the Play Developer API; the PBL is what your app links against to make purchases. As of August 31, 2026, new apps and app updates must use PBL v8 or later (v9.0 shipped May 19, 2026). That requirement applies to the AAB/APK you build and upload, not to anything GPC sends. See Google's Play Billing Library deprecation FAQ.

Commands ​

CommandDescription
subscriptions listList subscriptions
subscriptions getGet a subscription
subscriptions createCreate a subscription from JSON
subscriptions updateUpdate a subscription from JSON
subscriptions deleteDelete a subscription
subscriptions base-plans activateActivate a base plan
subscriptions base-plans deactivateDeactivate a base plan
subscriptions base-plans deleteDelete a base plan
subscriptions base-plans migrate-pricesMigrate base plan prices
subscriptions offers listList offers for a base plan
subscriptions offers getGet an offer
subscriptions offers createCreate an offer from JSON
subscriptions offers updateUpdate an offer from JSON
subscriptions offers deleteDelete an offer
subscriptions offers activateActivate an offer
subscriptions offers deactivateDeactivate an offer
subscriptions offers batch-getBatch get multiple offers
subscriptions offers batch-update-statesBatch activate/deactivate offers
subscriptions diffCompare local JSON vs remote

subscriptions list ​

List all subscriptions for the app.

Synopsis ​

bash
gpc subscriptions list [options]

Options ​

FlagShortTypeDefaultDescription
--page-sizenumberResults per page
--page-tokenstringPage token for pagination
--limitnumberMaximum total results
--next-pagestringResume from page token

Example ​

bash
gpc subscriptions list --app com.example.myapp
json
{
  "subscriptions": [
    {
      "productId": "premium_monthly",
      "basePlans": [
        {
          "basePlanId": "p1m",
          "state": "ACTIVE",
          "autoRenewingBasePlanType": {
            "billingPeriodDuration": "P1M"
          }
        }
      ]
    }
  ],
  "nextPageToken": null,
  "meta": { "count": 1 }
}

List output shape (v0.9.83+)

list commands return a JSON envelope: items under their named key, a nextPageToken (null when there are no more pages), a meta.count, and a message when empty. Earlier versions returned a bare array — switch jq '.[]' to jq '.subscriptions[]'.

Paginate:

bash
gpc subscriptions list --app com.example.myapp --page-size 10 --next-page abc123

subscriptions get ​

Get details for a single subscription by product ID.

Synopsis ​

bash
gpc subscriptions get <product-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions get premium_monthly --app com.example.myapp

subscriptions create ​

Create a new subscription from a JSON file.

Synopsis ​

bash
gpc subscriptions create --file <path>

Options ​

FlagShortTypeDefaultDescription
--filestring(required)Path to JSON file with subscription data
--activatebooleanfalseActivate all base plans after creation

The --activate flag creates the subscription and then activates all draft base plans in a single step, so you don't need a separate subscriptions base-plans activate call.

Client-side validation runs before the API call: the subscription JSON is checked for required fields, and prorationMode values are auto-fixed if they lack the expected prefix.

Example ​

Create the JSON file:

json
{
  "productId": "premium_monthly",
  "listings": {
    "en-US": {
      "title": "Premium Monthly",
      "description": "Full access to all premium features, billed monthly."
    }
  },
  "basePlans": [
    {
      "basePlanId": "p1m",
      "autoRenewingBasePlanType": {
        "billingPeriodDuration": "P1M"
      },
      "regionalConfigs": [
        {
          "regionCode": "US",
          "price": { "currencyCode": "USD", "units": "9", "nanos": 990000000 }
        }
      ],
      "state": "ACTIVE"
    }
  ]
}

Run the command:

bash
gpc subscriptions create \
  --app com.example.myapp \
  --file subscription.json

Create and activate base plans in one step:

bash
gpc subscriptions create \
  --app com.example.myapp \
  --file subscription.json \
  --activate

Preview without creating:

bash
gpc subscriptions create --file subscription.json --dry-run

subscriptions update ​

Update an existing subscription from a JSON file.

Synopsis ​

bash
gpc subscriptions update <product-id> --file <path> [options]

Options ​

FlagShortTypeDefaultDescription
--filestring(required)Path to JSON file with subscription data
--update-maskstringComma-separated field mask (e.g., listings,basePlans)
--regions-versionstring2022/02Regional pricing version. Pass a newer version (e.g. 2025/01) to opt in to Google's updated region/currency list.

Example ​

bash
gpc subscriptions update premium_monthly \
  --app com.example.myapp \
  --file subscription-update.json \
  --update-mask listings \
  --regions-version 2025/01

subscriptions delete ​

Delete a subscription. The subscription must have no active base plans.

Synopsis ​

bash
gpc subscriptions delete <product-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions delete premium_monthly --app com.example.myapp

subscriptions base-plans activate ​

Activate a base plan for a subscription.

Synopsis ​

bash
gpc subscriptions base-plans activate <product-id> <base-plan-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions base-plans activate premium_monthly p1m \
  --app com.example.myapp

subscriptions base-plans deactivate ​

Deactivate a base plan. Existing subscribers keep their plan until expiry.

Synopsis ​

bash
gpc subscriptions base-plans deactivate <product-id> <base-plan-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions base-plans deactivate premium_monthly p1m \
  --app com.example.myapp

subscriptions base-plans delete ​

Delete a base plan. The base plan must be deactivated first.

Synopsis ​

bash
gpc subscriptions base-plans delete <product-id> <base-plan-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions base-plans delete premium_monthly p1m \
  --app com.example.myapp

subscriptions base-plans migrate-prices ​

Migrate prices for a base plan across regions.

Synopsis ​

bash
gpc subscriptions base-plans migrate-prices <product-id> <base-plan-id> --file <path>

Options ​

FlagShortTypeDefaultDescription
--filestring(required)Path to JSON file with migration data

Example ​

Create the migration JSON:

json
{
  "regionalPriceMigrations": [
    {
      "regionCode": "US",
      "oldestAllowedPriceVersionTime": "2026-01-01T00:00:00Z",
      "priceIncreaseType": "OPT_OUT_PRICE_INCREASE"
    }
  ],
  "regionsVersion": { "version": "2026/03" }
}

Run the migration:

bash
gpc subscriptions base-plans migrate-prices premium_monthly p1m \
  --app com.example.myapp \
  --file migration.json

subscriptions offers list ​

List all offers for a specific base plan.

Synopsis ​

bash
gpc subscriptions offers list <product-id> <base-plan-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions offers list premium_monthly p1m \
  --app com.example.myapp

subscriptions offers get ​

Get details for a specific offer.

Synopsis ​

bash
gpc subscriptions offers get <product-id> <base-plan-id> <offer-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions offers get premium_monthly p1m free-trial-7d \
  --app com.example.myapp

subscriptions offers create ​

Create a new offer from a JSON file.

Synopsis ​

bash
gpc subscriptions offers create <product-id> <base-plan-id> --file <path>

Options ​

FlagShortTypeDefaultDescription
--filestring(required)Path to JSON file with offer data

Example ​

Create the offer JSON:

json
{
  "offerId": "free-trial-7d",
  "phases": [
    {
      "recurrenceCount": 1,
      "duration": "P7D",
      "pricingInfo": { "free": {} }
    }
  ],
  "targeting": {
    "acquisitionRule": {
      "scope": { "anySubscriptionInApp": {} }
    }
  },
  "state": "ACTIVE"
}

Run the command:

bash
gpc subscriptions offers create premium_monthly p1m \
  --app com.example.myapp \
  --file offer.json

subscriptions offers update ​

Update an existing offer from a JSON file.

Synopsis ​

bash
gpc subscriptions offers update <product-id> <base-plan-id> <offer-id> --file <path> [options]

Options ​

FlagShortTypeDefaultDescription
--filestring(required)Path to JSON file with offer data
--update-maskstringComma-separated field mask
--regions-versionstring2022/02Regional pricing version (e.g. 2025/01) for the offer

Example ​

bash
gpc subscriptions offers update premium_monthly p1m free-trial-7d \
  --app com.example.myapp \
  --file offer-update.json \
  --update-mask phases \
  --regions-version 2025/01

subscriptions offers delete ​

Delete an offer. The offer must be deactivated first.

Synopsis ​

bash
gpc subscriptions offers delete <product-id> <base-plan-id> <offer-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions offers delete premium_monthly p1m free-trial-7d \
  --app com.example.myapp

subscriptions offers activate ​

Activate an offer so it becomes available to users.

Synopsis ​

bash
gpc subscriptions offers activate <product-id> <base-plan-id> <offer-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions offers activate premium_monthly p1m free-trial-7d \
  --app com.example.myapp

subscriptions offers deactivate ​

Deactivate an offer. New users will no longer see it.

Synopsis ​

bash
gpc subscriptions offers deactivate <product-id> <base-plan-id> <offer-id>

Options ​

No command-specific options.

Example ​

bash
gpc subscriptions offers deactivate premium_monthly p1m free-trial-7d \
  --app com.example.myapp

subscriptions offers batch-get ​

Batch get multiple offers at once (max 100). Supports wildcard - for product-id and base-plan-id.

Synopsis ​

bash
gpc subscriptions offers batch-get <product-id> <base-plan-id> --ids <offer-ids>

Example ​

bash
gpc subscriptions offers batch-get premium_monthly p1m --ids offer1,offer2,offer3

subscriptions offers batch-update-states ​

Batch activate or deactivate multiple offers at once (max 100).

Synopsis ​

bash
gpc subscriptions offers batch-update-states <product-id> <base-plan-id> --file <path>

Example ​

bash
gpc subscriptions offers batch-update-states premium_monthly p1m --file states.json

subscriptions diff ​

Compare a local JSON file against the remote subscription state. Shows field-level differences for listings, basePlans, and taxAndComplianceSettings.

Synopsis ​

bash
gpc subscriptions diff <product-id> --file <path>

Options ​

FlagShortTypeDefaultDescription
--filestring(required)Path to local JSON file to compare

Example ​

bash
gpc subscriptions diff premium_monthly \
  --app com.example.myapp \
  --file subscription.json

Output shows each field that differs between local and remote:

Field: listings
  Local:  {"en-US":{"title":"Premium Monthly","description":"Updated desc"}}
  Remote: {"en-US":{"title":"Premium Monthly","description":"Original desc"}}

Field: basePlans
  No differences

Use --output json for structured diff output.

  • iap -- In-app products (one-time purchases)
  • purchases -- Purchase verification and management
  • pricing -- Regional price conversion

Made by · Free to use. Code on GitHub.

Not affiliated with Google LLC. Google Play is a trademark of Google LLC.