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
  • Developer Resources
  • 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

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 and Credit Notes


  • 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
  • Mobile SDKs and Wrappers
  • Articles and FAQ

Site Configuration


  • Add Users & Assign Roles
  • Chargebee Notifications
  • 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
  2. Product Catalog
  3. Articles and FAQ
  4. Migration
  1. Billing
  2. Product Catalog
  3. Articles and FAQ
  4. Migration

What is the process for upgrading to Latest Product Catalog? How long does the Latest Product Catalog migration take?

Problem Statement

You want to understand what the process for upgrading to latest product catalog? how long does the latest product catalog migration take is.

Scope

What is the process for upgrading to Latest Product Catalog?

How will this migration affect my existing subscriptions and customers? How long does the live migration process take? Will there be a service interruption for our customers with an active subscription? What possible blockers should I address before Latest Product Catalog Upgrade? What can cause delays in the process?

Solution

There are three stages to the Latest Product Catalog Upgrade: Qualification (1 day to 1 week), Data Mapping (1-2 weeks), and Migration (1-5 weeks).

During the migration, you cannot make any changes to your Product Catalog and should plan on a two to six-week process. The timeframe depends on your response time, the complexity of your instance, and the current queue for Upgrading.

Qualification Stage:

You control how quickly or slowly you move through this stage. You will communicate with your CSM (if you have one) or with support and complete a qualification questionnaire, and sign a consent document.

Data Mapping Stage:

  • (1-2 weeks) The custom engineering team reviews your qualification checklist, asks questions, and provides feedback about your instance for any items requiring further investigation.
  • You will complete a Product Catalog Mapping sheet (that will be shared with you). The time needed for this step largely depends on the number of items in your Product Catalog.
  • Once the Product Catalog Mapping sheet is finalized, you can only make changes to the Product Catalog after the Upgrade is complete.
  • 1-2 Days will be taken to validate the data on the sheet and confirm if we are good to proceed with the test migration.

Migration:

  • (1-5 weeks)
  • 1-2 Days: Your test site is cleared of data, and all product catalog data is transferred from Live to Test. This clean slate ensures we're testing the exact products on your Live site.
  • You will update any APIs / drop scripts you utilize, perform testing, then upgrade your Live site.
  • Test instance is upgraded, and test data migration is done.
  • You will work closely with our custom engineering team to validate and test data. You will continue testing and provide your sign-off for the Live site migration.
  • You validate and confirm the mapping sheet is still valid for Live migration.
  • 1 Day: Live migration is performed.

What possible blockers should I address before Latest Product Catalog Upgrade? What can cause delays in the process?

In short, the complexity of your site setup is a good predictor of your migration timeline.

Consider the following items when creating the timeline for the migration:

  • You should be on Hosted Pages Version 3 to be compatible with Latest Product Catalog, Hence this process should be completed before you initiate the Latest Product Catalog upgrade process

  • You need to upgrade API integrations to the new structure. Please review the details here.

  • You have SFDC integration (Then Upgrade the SFDC Integration to V 1.48 and above)

  • Plan ID changes are required. Latest Product Catalog does not support special characters (£, &, !, etc), or there is a duplicate ID between a plan and addon.

    You're live site will be down for 2 hours max, and we will coordinate with you about the best time to complete this migration. Please remember that the time taken is proportional to the amount of data on your Live Site. As a best practice, we discourage using Chargebee Live Site during the migration. But scheduled renewals will be unaffected. You will need to deploy API / drop-in script changes to the Live Site at the same time.

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?