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

Product Updates


  • Release Notes

Getting Started


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

Implementing Chargebee


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

Agentic AI


  • Chargebee Copilot
  • Catalog Setup Assistant
  • MCP Servers

Developer Resources


  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Chargebee Apps


  • Chargebee Apps CLI Developer Guide

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

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Overview
  • Use Cases
  • Setting up Usage Based Billing
  • Usage Alerts
  • Prepaid credits
  • Mid-term Subscription Changes
  • FAQs

Invoices and Credit Notes


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

Taxes


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

E-Invoicing


  • Overview
  • Enabling E-Invoicing

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Mobile SDKs and Wrappers
  • Articles and FAQ

Site Configuration


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

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel Subscriptions (Legacy)

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
  • E-Invoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • 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
  2. Product Catalog
  3. Articles and FAQ
  4. Migration
  1. Billing
  2. Product Catalog
  3. Articles and FAQ
  4. Migration

How to enable Latest Product Catalog? What are some key changes to note?

Problem Statement

This article is for customers using Legacy Product Catalog who want to migrate to Latest Product Catalog.

Related Scenarios

  • I want to understand the new features of Latest Product Catalog
  • I want to test the new features on my test site
  • I am an existing Chargebee user — how do I migrate to Latest Product Catalog?
  • Are there any limitations for Latest Product Catalog?

Solution

Latest Product Catalog can be easily enabled on an existing Chargebee site. Though there are no limitations, there are a few prerequisites to consider before migration to ensure the process is smooth.

Some of the prerequisites are

  • First, you experience the exciting features of Latest Product Catalog firsthand by creating a new test site. Here's more on how to create a new test site (this will be your trial site and will be discarded once we proceed further with migration)

  • Understand the Compatibility of your preferred third-party integrations with the Chargebee team as some of the third-party integrations are still a work in progress. (our support team will be guiding you through this step as well)

Important points to know before upgrading to Latest Product Catalog

  1. Subscriptions:

You cannot create a new subscription without creating a customer record. In Legacy Product Catalog, if you navigate to the subscriptions tab and choose 'Create new subscription', it will automatically create a customer and subscription record. However, with Latest Product Catalog, you would need to ensure that there is an existing customer record, or you would need to create a new customer record while choosing the 'create new subscription' option.

  1. Third-party integrations:

The third-party integrations listed below are incompatible with Latest Product Catalog and will work with Legacy Product Catalog only:

  • Mailchimp

  • WordPress

  • Referral Candy

  • ActiveCampaign

  • Natero

  • Baremetrics

  • Klaviyo

  • Groww

  • EagleEye

  • Pipe

  • Encharge

Other than this, there are a few other key changes to be made

You will need to update the objects if you use Chargebee APIs for Checkout, custom integrations, or drop-in script.

You will be upgraded to our Leap UI.

You must be on Salesforce Integration v1.48 or above

As a part of Latest Product Catalog Upgrade, you will merge Plans/Addons, which are the same product/service but have different currency/billing frequencies, into a single plan where the plans in Legacy Product Catalog become individual price points in Latest Product Catalog. Please review the Product Family structure for more information.

This is why we recommend that you sign up for a free test site (which will automatically be on Latest Product Catalog) to see and understand the difference between Legacy Product Catalog and Latest Product Catalog firsthand.

Here are a few links on Latest Product Catalog which I think would be helpful.

Introduction Video

Help documentation (this is the documentation curated for Latest Product Catalog)

API Documentation (this is the API document curated specifically for Latest Product Catalog, and these are the API calls you will be using with Latest Product Catalog)

Refer to your Chargebee CSM or support team for the process and timelines for migration.

Note

Please be assured that we will support you throughout the migration process to ensure smooth upgradation to Latest Product Catalog from Legacy Product Catalog. Once you have gone through the test site, please reachout to support or your CSM, to initiate the process.

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
How can I check if my site is on Coexistence Mode or 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?