Catalog Management

Catalog Management

Manage the Android product catalog across two surfaces: the Google Play Console (source of truth for products) and the RevenueCat dashboard (entitlements, offerings, targeting). You do not call the Google Play Developer monetization.subscriptions or monetization.onetimeproducts endpoints from your app or backend.

Phase 1: Understand

Read this phase before you touch anything.

Why two surfaces

| Surface | Owns | Examples | |---|---|---| | Google Play Console | Underlying products, base plans, offers, prices | premium_monthly, base plan p1m, intro offer | | RevenueCat dashboard | Entitlements, Offerings, Packages, Targeting | pro entitlement, default offering, $rc_monthly package |

Play Console holds the billable SKU. RevenueCat decides which SKU gets surfaced to which user and under which entitlement key.

What changes without an app update

When your app calls awaitOfferings(), it fetches whatever the RevenueCat dashboard has configured. Offering edits, package swaps, and targeting rules propagate on the next app launch. No binary release is required.

When to use the REST API

If you need to automate catalog edits from a backend (for example, seeding dozens of offerings across environments), use the RevenueCat REST API for products, entitlements, and offerings. You still do not talk to Google directly. Play Console remains the product source of truth.

Phase 2: Plan

Before you make a change, decide:

1. Is this a new product, or a repackaging of an existing one?

• New product: start in Play Console.
• Repackaging (new offering, new targeting, new entitlement mapping): stay in RevenueCat.

1. Which entitlement does the product unlock? If you do not have a matching entitlement, create one first.
2. Which offering and package identifier? Decide the package identifier (for example $rc_monthly, $rc_annual) so your paywall code keeps working.
3. Does targeting need to change? If different users should see different offerings, plan the placement name and the targeting rule (OS version, country, custom attribute).

Phase 3: Execute

The end to end flow for adding a new subscription product.

Step 1: Add the product in the Play Console

1. Open Play Console -> your app -> Monetize -> Products -> Subscriptions.
2. Click Create subscription.
3. Set the product ID (for example premium_monthly), name, and description.
4. Add a base plan (billing period, renewal type, price).
5. Optionally add offers (intro pricing, free trial).
6. Activate the subscription.

Wait a few minutes for Play to propagate the product.

Step 2: Import into RevenueCat and attach an entitlement

1. Open the RevenueCat dashboard -> your project -> Products.
2. Click Import to sync from the Play Console. The new product appears in the list.
3. Open the product and attach it to an existing entitlement, or create a new one.

• Entitlement example: pro. Every product that unlocks pro features attaches to pro.

Your client code checks entitlements by key:

val isPro = customerInfo.entitlements["pro"]?.isActive == true

Step 3: Wire the product into an Offering as a Package

1. In the dashboard, open Offerings.
2. Pick the offering you want to edit, or create a new one (for example default).
3. Add a Package. Choose a package identifier that matches your paywall:

• $rc_monthly for monthly
• $rc_annual for annual
• Or a custom identifier

1. Attach the Play Console product to the package.
2. Save. Mark the offering as Current if it should be the default.

Your client code stays the same:

val offerings = Purchases.sharedInstance.awaitOfferings()
val monthly = offerings.current?.monthly

Step 4 (optional): Targeting

If different users should see different offerings, use placements.

1. In the dashboard, open Targeting -> Placements.
2. Create a placement (for example paywall_upsell).
3. Add rules (OS version, country, custom attribute) that map users to specific offerings.

Client code:

val offering = offerings.getCurrentOfferingForPlacement("paywall_upsell")
    ?: offerings.current

No app update is required when you change targeting rules later.

Phase 4: Verify

Check the change landed before you close the task.

| Check | How | |---|---| | Product exists in Play | Play Console -> Subscriptions shows the product as Active | | Product imported to RC | Dashboard -> Products lists the product | | Entitlement mapping | Dashboard -> Entitlements shows the product under the right entitlement | | Offering wiring | Dashboard -> Offerings shows the product attached to the expected package | | Runtime fetch | Launch the app, call awaitOfferings(), confirm the package resolves | | Entitlement unlock | Complete a test purchase, confirm customerInfo.entitlements["pro"].isActive is true |

If awaitOfferings() returns null for a package you expect, the most common causes are: the offering is not marked Current, the product is not attached to the package, or Play has not finished propagating the product.

Common Mistakes

• Calling monetization.subscriptions from your backend. Use RevenueCat instead.
• Creating an offering before importing the product. Import first, then wire.
• Shipping hard coded product IDs in your paywall UI. Use package identifiers so you can swap products without an app release.
• Forgetting to mark an offering as Current. Clients that call offerings.current will see the old offering until you flip this.

References

• Full chapter

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: RevenueCat
• Source: RevenueCat/play-billing-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.