Name: rc-catalog-management
Author: revenuecat

Use this skill when managing the Android product catalog through the Play Console and the RevenueCat dashboard. Covers the two sided catalog flow (create in Play Console, import or map in RevenueCat), entitlement and offering maintenance, and why you do not call the Google Play Developer API directl

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. 2. Which entitlement does the product unlock? If you do not have a matching entitlement, create one first. 3. Which offering and package identifier? Decide the package identifier (for example $rc monthly , $rc annual ) so your paywall code keeps working. 4. 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: 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 4. Attach the Play Console product to the package. 5. Save. Mark the offering as Current if it should be the default. Your client code stays the same: 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: 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](https://www.revenuecat.com/guides/revenuecat android sdk/catalog management)