New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Getting Started

  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee

  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee

  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model context protocol)

Product Catalog

  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions

  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers

  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Invoices, Credit Notes and Quotes

  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes

  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities

  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration

  • Users & Roles
  • Custom Fields & Metadata
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Reports and Analytics

  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations

  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • Articles and FAQ

Data Privacy & Security

  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations

  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  3. Product Catalog
  5. Articles and FAQ
  6. Migration
  1. Billing
  3. Product Catalog
  5. Articles and FAQ
  6. Migration

How can I check which Product Catalog version my site is using?

Problem Statement

You need to determine which Product Catalog version (Legacy, Coexistence Mode, or Latest Product Catalog) your Chargebee site is using.

Related Scenarios

  • How can I check which Product Catalog my site is using?
  • How do I know which Product Catalog my site is on?
  • How can I verify the Product Catalog version of my site?
  • How do I determine which catalog my site is using?
  • How do I identify the Product Catalog type for my site?

Solution

Site Configuration via UI

Go to Product Catalog in the left navigation.

  • If you see Product Families and Charges, your site is using the Latest Product Catalog experience. This is true for both Latest Product Catalog and Coexistence Mode.
  • If you do not see Product Families and Charges, your site is still on the Legacy Product Catalog (not in Coexistence Mode).

Site Configuration via API

To distinguish between Coexistence Mode and Latest Product Catalog only, use the configurations API:

Request:

GET https://{site}.chargebee.com/api/v2/configurations

Response:

See the full response in the API docs: Configurations API.

Attributes:

NameDescription
domainSTRING The Chargebee "site" for which the information has been requested. It is the same as the value of {site} provided as a path parameter.
product_catalog_version

ENUM The Product Catalog version of the site. Possible values are

  • v1
  • v2
chargebee_response_schema_type

ENUM Indicates the response schema type used by the site. Use this value to determine whether your site is on Latest Product Catalog (items), Coexistence Mode (compat), or Legacy Product Catalog (plans_addons).

Related Articles

Will the plan ID be linked to the subscriptions in Legacy Product Catalog be changed after the site is migrated to Latest Product Catalog?
Can I move only selected plans and addons to Latest Product Catalog?
How can we test our code after the Latest Product Catalog upgrade on our Test Site?
Can we change the structure of our product catalog as a part of Latest Product Catalog migration ?
Is it possible to override quantity and price of tiered/Volume/Stairstep plan in Latest Product Catalog?
Do all plans in the 1.0 live system need to be mapped to a 2.0 item price id i.e. even archived ones?
Advantages of Latest Product Catalog
'Error: "The API endpoint is incompatible with the product catalog version. You are calling Legacy Product Catalog API endpoint but you are using Latest Product Catalog"'

Show more

Was this article helpful?