Keeping the Billing Catalog Ready for Fast Pricing Tweaks

Why we treat the UsageBox catalog like product infrastructure, and how versioned changes keep experiments safe.

6 min read

product catalogpricing iterationbilling automation

Every pricing change used to hijack our roadmap. Engineers patched JSON files, QA reran smoke tests, and finance waited for us to redeploy. We finally pulled pricing out of the codebase and into UsageBox’s catalog so product managers could run experiments without filing tickets.

How We Model the Catalog

Everything lives in Firestore:

  • Products describe the services we sell.
  • Plans bundle products, quotas, and commitments.
  • Meters set how usage is rated.
  • Entitlements toggle features on or off per plan.

Because each change is versioned, we can diff an experiment against production before anything goes live.

The Change Workflow

  1. Clone the current plan and name the experiment clearly.
  2. Adjust meters, price points, or entitlements in the dashboard.
  3. Assign the plan to a limited cohort, usually a handful of beta accounts.
  4. Schedule a rollback time so we can revert automatically if metrics trend badly.

The backend starts rating new usage with the updated rules immediately. Existing subscribers stay on their prior version until we migrate them intentionally.

Scenarios We Repeat Often

  • New feature launch: add a metered add-on with an introductory price, then ratchet up once we understand adoption.
  • Regional pricing: duplicate plans per currency and use customer attributes to assign them.
  • Promotions: set an effective start and end date so discounts stop without manual cleanup.

Metrics That Tell Us If It Worked

  • Trial-to-paid conversion for the cohort on the new plan
  • Average revenue per account versus the control group
  • Support tickets tagged as “pricing” or “quota”
  • Upgrade/downgrade flow completion rates

Tips We Learned the Hard Way

  • Keep change logs in Confluence so go-to-market teams know what shifted and why.
  • Send proactive customer emails for any adjustment that could impact an invoice.
  • Measure experiments for at least one full billing cycle before calling a winner.

By treating pricing as configuration instead of code, we iterate faster and spend our engineering calories on the product itself. If you’re still editing constants and shipping hotfixes, moving your catalog into UsageBox will feel like a breath of fresh air.

Key Topics

  • product catalog
  • pricing iteration
  • billing automation

Related Articles

Explore more articles on similar topics to deepen your understanding of usage-based billing.

Product Catalog Management That Keeps Pricing Moving

How UsageBox centralizes catalog workflows so product, finance, and engineering can launch pricing changes without sprea...

6 min readRead more

The Fable 5 Usage-Credits Switch (July 20): the 50% Rule, the Math, and the July 17 False Alarm

Included Fable 5 access on Claude subscriptions ends July 19, 2026; from July 20 every Fable 5 token beyond the plan's i...

9 min readRead more

AI Credits Are the New Pricing Primitive: Three Cutovers in Seven Weeks (GitHub, OpenAI, Anthropic)

Between June 1 and July 20, 2026, GitHub, OpenAI, and Anthropic all moved flagship products onto credit-based metering: ...

10 min readRead more

Explore More Articles

Discover our complete collection of usage-based billing guides and implementation patterns.

View all articles