rc-offerings-metadata

name	rc-offerings-metadata
description	Create and update RevenueCat offering metadata including packages, color schemes, review content, and paywall configuration via the internal dashboard API. Use when asked about offerings metadata, paywall configuration, package setup, or offering updates.

RevenueCat Offering Metadata

Offerings are managed via the internal dashboard API (rc-internal offerings).

Update Offering Metadata

rc-internal internal offerings update -o <offering_id> --metadata '{
  "title": "Unlock Pro",
  "subtitle": "Get access to all premium features",
  "features": ["Feature 1", "Feature 2", "Feature 3"],
  "colorScheme": {
    "dark": { "primary": "#6366F1", "background": "#1E1B4B", "secondaryText": "#A5B4FC" },
    "light": { "primary": "#4F46E5", "background": "#FFFFFF", "secondaryText": "#4338CA" }
  },
  "packages": [
    { "rcIdentifier": "weekly", "type": "weekly", "title": "Weekly", "subtitle": "Try Pro this week", "shouldBeGivenProminance": false },
    { "rcIdentifier": "annual", "type": "annual", "title": "Yearly", "subtitle": "Best value", "shouldBeGivenProminance": true },
    { "rcIdentifier": "lifetime", "type": "lifetime", "title": "Lifetime", "subtitle": "One-time unlock" }
  ],
  "primarySelectedPackageIndex": 1,
  "headerImageURL": "https://example.com/header.png",
  "privacyPolicyURL": "https://example.com/privacy",
  "termsAndConditionsURL": "https://example.com/terms",
  "reviews": [
    { "review": "Great app!", "reviewer": "User", "stars": 5 }
  ]
}'

Update Offering Name/Identifier

rc-internal internal offerings update -o <offering_id> -n "New Name"
rc-internal internal offerings update -o <offering_id> -i new-identifier

Manage Packages

# Update packages (attach/detach products to packages)
rc-internal internal offerings update -o <offering_id> --packages '[
  {
    "identifier": "my.weekly",
    "displayName": "Weekly",
    "products": [{ "productId": "prodXXXX" }]
  }
]'

Create Offering

rc-internal internal offerings create -i weekly -n "Weekly" --platform IOS

Duplicate Offering

# Full duplicate (structure + packages)
rc-internal internal offerings duplicate -o <offering_id> -i new-id -n "New Name"

# Packages only
rc-internal internal offerings duplicate -o <offering_id> -i new-id -n "New Name" --packages-only

Set Current/Default

rc-internal internal offerings set-current -o <offering_id>

Metadata Schema Reference

Field	Type	Description
title	string	Paywall title
subtitle	string	Paywall subtitle
features	string[]	Feature bullets
colorScheme.dark	object	Dark mode colors
colorScheme.light	object	Light mode colors
packages	object[]	Package configurations
packages[].rcIdentifier	string	Package identifier (weekly, annual, lifetime)
packages[].type	string	Package type
packages[].title	string	Display title
packages[].subtitle	string	Display subtitle
packages[].shouldBeGivenProminance	boolean	Feature prominently
primarySelectedPackageIndex	number	Default selected package (0-indexed)
headerImageURL	string	Header image URL
privacyPolicyURL	string	Privacy policy URL
termsAndConditionsURL	string	Terms and conditions URL
reviews	object[]	Customer reviews

Color Scheme Object

{
  "primary": "#6366F1",
  "background": "#1E1B4B",
  "secondaryText": "#A5B4FC"
}