Create and manage subscriptions

In May 2022, we introduced changes in the way subscription products are defined and managed in Play Console. If you have existing subscriptions and want to know how these changes affect them, read this article.

This page explains how to create and manage subscriptions in Play Console. We recommend that you read this article to familiarize yourself with the subscription concepts, objects, and functionality before continuing.

When using Play Console, you need to separately configure and manage subscriptions, base plans, and offers in that order.

Availability

If you're in a supported location for merchant registration, you can use Google Play's billing system.

If you’re in a supported location and want to start using Google Play's billing system features in your apps, set up a payments profile and review the Google Play billing system API documentation.

Create and manage subscriptions

Click on a section below to expand or collapse it.

Create a new subscription

Before creating a subscription, make sure to plan your product IDs carefully. Product IDs must be unique for your app, and they can’t be changed or reused after they’ve been created.

  • Product IDs must start with a number or lowercase letter, and can also contain underscores (_), and periods (.), and can have a maximum of 40 characters.
  • Note: The product ID android.test is unavailable for use, along with all product IDs that start with android.test.

Before creating a subscription, review our Subscriptions policy.

To create a subscription:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Click Create subscription.
  3. Enter your subscription details.
    • Product ID: The product ID must start with a number or lowercase letter, and can also contain underscores (_), and periods (.), and can have up to 40 characters.
    • Name: A short name for your subscription of up to 55 characters. Users will see this in emails and the subscription center.
      • You, as a developer, must be transparent about any subscription services or content you offer within your app. 
      • Your subscription name must accurately reflect your offer. For example, don’t name your subscription “Free Trial.”
  4. Click Create.
  5. Click Edit subscription details to view and edit the "Subscription details" page. You have the option to add more information here
  6. Next to "Benefits," Click + Add benefit and enter a description of a feature of your subscription. You can add up to 4 benefits (up to 40 characters each).
    • Benefits should highlight the features to give users a better idea of what your subscription offers, like “Full catalog of TV shows and movies.” 
    • Since not all users will be eligible for a promotional price or free trial, the benefit should not mention free trial or price, for example “Try 7 days free” is not allowed.
  7. Next to "Description,"  enter an optional description for your subscription. This is for your own internal use; it is not shown to users on Google Play.
  8. You may need to provide information about the product that you’re distributing for consumer law or tax purposes. If so, scroll to the "Tax and compliance" section and click Manage settings.  Learn more about tax and compliance settings.
  9. Click Save changes.

For the subscription to be available to Google Play users, you need to create and activate at least one base plan. Note that once you create a base plan, you can no longer delete the subscription. Instead, you need to archive the subscription once you stop selling it.

Edit an existing subscription
  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Click Edit subscription details and make your changes.
  4. Click Save changes.

Create and manage base plans

Click on a section below to expand or collapse it.

Create and activate a base plan

Before creating a base plan, make sure to plan your base plan IDs carefully. Base plan IDs must be unique for your app, and they can’t be changed or reused after they’ve been created.

Base plan IDs must start with a number or lowercase letter. You can use numbers (0-9), lowercase letters (a-z), and hyphens.

To create a base plan:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to create a base plan in, click the right arrow to view the subscription details.
  3. Click Add base plan.
  4. Enter a base plan ID. The base plan ID must be unique for your app, and it can’t be changed or reused after it's been created.
  5. Choose the renewal type:
    • Auto-renewing: Automatically renews unless canceled by the user.
    • Prepaid: Users will need to make a manual payment to extend their plan.
  6. If you're creating an auto-renewing base plan, define the following:
    • Billing period: Select the duration of the subscription entitlement. The available billing periods are:
      • 1 week
      • 4 weeks
      • 1 month
      • 3 months
      • 6 months
      • 1 year
    • Grace period: Select the duration for which users will retain access to subscription benefits while they’re asked to fix their payment issue if auto-renewing charges fail. Any offers you add to this base plan will always inherit this grace period length.
    • Billing plan and offer changes: Choose how to apply any remaining paid days when users change offers
    • Resubscribe: Allow (or don't allow) users to resubscribe from the Google Play Store after their subscription has been canceled or expired.
  7. If you're creating a prepaid base plan, define the following:
    • Duration: Select the duration of the subscription entitlement. The available duration options are:
      • 1 day
      • 3 days
      • 1 week
      • 4 weeks
      • 1 month
      • 3 months
      • 6 months
      • 1 year
    • Allow extension: Allow users to extend the duration from the Google Play Store
  8. (Optional) Add tags to identify the base plan or the offer in the API. Tags can be used to determine which offer to show when the user is eligible for more than one. You can add up to 20 tags.
  9. At the top right of the "Price and availability" section, click Manage country / region availability. to select the locations your base plan will be available.
    • Users can only purchase your subscriptions in the regions where your base plan is available. The user's Google Play country is used to determine which base plans are available to them.
    • If you choose to make your subscription base plan available in “New countries/regions,” when Google adds support for a new buyer currency in a country where you already distribute your app, we'll automatically make your base plan available too. Learn more about offering apps in multiple currencies.
  10. After you've made your selections, click Apply.

To set the price of a base plan in multiple countries/regions at once:

  1. Click Update prices and select the countries/regions you want to set the prices in bulk.
  2. Click Set price
  3. Enter the tax-exclusive price and currency you want to use.
    • This price will be converted into the appropriate currency for each country/region, tax will be added for tax-inclusive jurisdictions, and then the price is charmed to comply with local customs.
  4. Click Update
  5. Click Save

To set the price of a base plan in a single country/region

  1. Click on the pencil icon in the "Price" column of the table to enter a price in that location.
    • Taxes will be applied automatically after entering a price.
    • In regions where Google Play does not support local currency, you can specify the availability of your base plan price in USD or EUR.
  2. Click Save

To activate the base plan:

  1. Click Save
  2. Click Activate to make the base plan available to users.
Edit an existing base plan

If you want to change your base plan's prices, read about changing base plan and offer prices first.

To edit a base plan:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Under "Base plans and offers," click the right arrow next to the base plan you want to edit.
  4. When you're finished making changes, click Save changes.

Note: When you remove a region from the base plan, that base plan is no longer available to users in that region for new purchases. However, existing subscribers to an auto-renewing base plan continue to auto-renew even when their region is removed from the base plan.

Deactivate or reactivate a base plan

You can deactivate a base plan to prevent new purchases. It does not affect any existing subscriptions. To deactivate a base plan:

Important: Deactivating a base plan will also deactivate all of its offers.

To deactivate a base plan:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow next to the base plan you want to deactivate.
  3. Under "Base plans and offers," click the right arrow to view the base plan details.
  4. At the top right of the page, click Deactivate.

To reactivate the base plan, and allow new purchases again:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Under "Base plans and offers," click the right arrow next to the base plan you want to reactivate.
  4. At the bottom of the page, click Activate.

Create and manage offers

Click on a section below to expand or collapse it.

Create and activate an offer

Before creating an offer, make sure to plan your offer IDs carefully. Offer IDs must be unique for your app, and they can’t be changed or reused after they’ve been created.

Offer IDs must start with a number or lowercase letter. You can use numbers (0-9), lowercase letters (a-z), and hyphens.

Before you start creating an offer, note the following:

  • You must communicate your offer clearly in any in-app promotions or splash screens. 
  • You must be explicit about your offer terms, offer ends, including how much users will be charged, the frequency of your billing cycle, how they can cancel, and whether a subscription is required to use the app. Users should not have to perform any additional action to review the information.
  • Offers are optional; you don't need to create an offer for your base plan to be available.
  • You must have a saved base plan (draft or active) to create an offer. An offer is always linked to a single base plan.
  • By default, offers are available to the same regions as their associated base plan. Within an offer, you can optionally restrict availability to a subset of base plan regions.

To create an offer:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. In the "Base plans and offers" section, click Add offer.
  4. Select the base plan you want to add the offer to from the drop-down list and click Add offer.
    • Note that offers can only be added to auto-renewing base plans
  5. Enter an offer ID. The offer ID must be unique for your app, and it can’t be changed or reused after it's been created.
  6. Your offer automatically inherits the availability of the base plan it's associated with. To change this, click Manage country / region availability. You can only select regions targeted by your base plan.
  7. Select the offer's eligibility criteria to determine which customers the offer is available to; New customer acquisition, Upgrade, or Developer determined. Learn more about offer eligibility.
  8. For a new customer acquisition offer, select one of these options: 
    • Never had this subscription: This offer will be available to users who never had this subscription.
    • Never had any subscription: This offer will be available to users who never had any subscription in your app.
  9. For an upgrade offer, complete the following fields:
    • Current subscription: The offer is only available to users who currently have this subscription.
    • Existing billing period: The offer is only available to users who have this billing period. This is useful, for instance, to create an annual upgrade offer for users who currently have any monthly base plan or offer.  
    • Redemption gap: How many times a user may purchase this offer (once or unlimited)
  10. For a developer-determined offer, you decide the eligibility logic in your app. Examples include second-chance free trials, or win-back offers for lapsed subscribers.
  11. (Optional) Add tags to identify the base plan or the offer in the API. Tags can be used to determine which offer to show when the user is eligible for more than one. You can add up to 20 tags.

To add phases to an offer:

  1. Under "Phases," click Add phase to add a free trial and/or introductory pricing phases. An offer must contain at least one pricing phase. 
  2. Select the type of pricing phase:
    • Type: Choose the phase type from the following:
      • Single payment: Subscribers pay up front for a specified period
      • Recurring payment: Subscribers pay each period for a specified number of periods
      • Free trial: Subscribers received a specified number of days, weeks, months or years at no charge.
        • Free trials must be between 3 days and 3 years.
    • Duration: For free trial and single payment types, enter the number of days, weeks, or months.
    • Billing periods: If type is a recurring payment, select the number of billing periods.
    • Price overrides: For single or recurring payments, choose the price override type from the following:
      • Fixed amount: A set amount, such as $5
      • Percentage discount: A percentage discount from the base price, for example, 50%
      • Absolute discount: A fixed discount from the base price, for example, $1 off

To set the price or discount in multiple countries/regions at once:

  1. Click Update all discounts/Update all prices and select the countries/regions you want to set the prices in bulk.
  2. Click Set price/Set discount.
  3. Enter the tax-exclusive price and currency you want to use.
    • This price will be converted into the appropriate currency for each country/region, and tax will be added for tax-inclusive jurisdictions, and (for fixed amount offers only) the price is charmed to comply with local customs.
  4. Click Update.
  5. Click Apply.

To set the price or discount in a single country/region:

  1. Click on the pencil icon in the "Price" column of the table to enter a price in that location.
    • Taxes are applied automatically after entering a price.
    • In regions where Google Play does not support local currency, you can specify the availability of your base plan price in USD or EUR.
  2. Click Apply.

To activate the offer: 

  1. After you've added your phases, click Save.
  2. Click Activate to make the offer available to eligible users.
Edit an existing offer

If you want to change your offer's prices, read about changing base plan and offer prices first.

To edit an offer:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Under "Base plans and offers," click the right arrow next to the offer you want to edit.
  4. When you're finished making changes, click Save changes.
  5. Click Save changes.
Deactivate or reactivate an offer

You can deactivate an offer to prevent new purchases. However, any existing subscribers will continue to benefit from the offer.

To deactivate an offer:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Under "Base plans and offers," click the right arrow next to the offer you want to deactivate.
  4. At the top right of the page, click Deactivate.

To reactivate the offer, and allow new purchases again:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Under "Base plans and offers," click the right arrow next to the offer you want to reactivate.
  4. At the bottom of the page, click Activate.

Ending legacy price cohorts

For auto-renewing base plans, you can decide to end a legacy price cohort and move those users to the current base plan price. However, note the following:

  • Ending a legacy price cohort only affects the base plan price; it's not possible to change the price of any offer phase after purchase.
  • It's also not possible to move the legacy cohort to any price, only to the current base plan price.
End a legacy price cohort

 To end a legacy price cohort:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Next to the subscription you want to edit, click the right arrow to view the subscription details.
  3. Under "Base plans and offers," click the three dots icon  next to the base plan containing the legacy price cohort you wish to end, and select Migrate legacy price points.
  4. Select the countries/regions you want to end the price cohort, and click on Choose date and migrate
  5. Choose the date of legacy price cohorts you wish to end, and click on Confirm Migration.
    • Users who subscribed up to and including this date will be migrated to the current price.

Featured subscriptions

In addition to selling subscriptions from within your app, selected developers can sell a featured SKU directly from the Play Store using featured subscriptions. 

Our research suggests that selling subscriptions directly from the Play Store can potentially lead to an increase in subscribers, but also to a decrease in installs. We recommend that you carefully consider whether this trade-off is suitable for your app before setting up a featured subscription. Featured subscriptions may be a better option for apps that keep a significant amount of their content behind a subscription paywall, for example. This feature is enabled in the US only.

Note: You must implement the purchase ack API in your app. You can learn about implementing the purchase ack API on the Android Developers site.

Set up a featured subscription

Before setting up your featured subscription, ensure that it has the correct title and description on your store listing page, and that it has been localized into other languages. Users will see this information on your store listing page.

To set up a featured subscription:

  1. Open Play Console and go to the Subscriptions page (Monetize > Products > Subscriptions).
  2. Under "Featured subscriptions," click Create to set up a new featured subscription, or click the right arrow icon next to an existing featured subscription to make changes.
  3. Click + Country/region and select the locations you want to target.
  4. Under “Subscriptions,” click + Add a subscription. You can choose 1-3 subscriptions to feature. Make sure you have the correct localization for the subscriptions you choose.
  5. Under “Surfaces” choose the surfaces you want to offer your featured subscription on. There are up to three options available for each surface:
    • Use for all: All eligible users can see and purchase your featured subscription.
    • Use for licensed testers only: Only licensed testers can see and purchase your featured subscription. You can use this option to test your subscription before releasing it to production.
    • Don't use: The featured subscription is not available to any users. This option is selected by default.
  6. Save your changes.

Related content

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Search
Clear search
Close search
Google apps
Main menu
Search Help Center
true
92637
false
false