Getting Started

Product Catalog



Invoices, Credit Notes, and Quotes



Site Configuration

Data Privacy & Security

Data Operations

Reports and Analytics


Product Families 


When your business offers multiple products or services, each with their own set of plans and addons, managing or scaling your product catalog could become challenging. You can manage this complexity by creating product families in Chargebee, that help you categorize your plans and addons for specific product or service that is offered to your customers.

For example, Acme Inc is a SaaS(Software as a Service) business that provides software applications like Customer Relationship Management Software (CRM) and Human Resource Management Software (HRMS) to other businesses. Each application has two different plans to choose from - Standard and Enterprise. Acme Inc. also offers additional users, and implemention support for the applications.

Product Families allow for grouping these different plans (product levels), addons, and charges into clusters that belong to specific products. For instance, in the above example, product families are CRM and HRMS. Plans, addons, and charges can be created and associated to respective product families.

You can present your plans and addons to customers contextually based on these product families. Your customers can only upgrade or downgrade between plans within the same product family.

Configuring Product Family 

Product Families setting must be enabled in your Chargebee site for users to create product families and associate plans and addons to them. By default, this setting is disabled in your site. To enable product families,

  1. Click Settings > Configure Chargebee > Pricing > Pricing Management.
  2. In the Essential Settings page, click to enable Product Family.

Once product families setting is enabled:

  • You cannot disable product families in your Chargebee site.
  • While creating plans and addons, the product family to which you are associating it must be specified.

Creating a Product Family 

Once you have enabled product families in your site, you can start creating product families and categorizing your plans and addons under these product families.

To create a new product family,

  1. Click Product Catalog > Product Families > + Create Product Family.
  2. In the Create a Product Family page, enter the product family name, description, and modify the product family id(if required).
  3. Click Create.

Once you create the product families as required, you can associate plans and addons with the respective product families while creating or editing the plan or addon.

Editing a Product Family 

To edit an existing product family,

  1. Click Product Catalog > Product Families.
  2. From the list of product families, navigate to the record that you wish to edit, click the more icon and click Edit Product Family.
  3. In the Edit Product Family page, you can edit the product family name and description.
  4. Click Update.
  • You can not edit the product family id field.
  • If you allow your customers to change their subscriptions in Portal, subscription change is allowed only for plans/addons within the same product family.


What are some factors that I need to consider before grouping my plans and addons into product families? 

If you have multiple products or services, each with their own set of plans and addons, consider the following factors before you group them into product families:

  • Migrating subscriptions from one plan to another plan is possible only when the plans belong to the same product family. Otherwise, existing subscription needs to be cancelled, and a new subscription has to be created with the plan from another family.
  • Addons, charges, and coupons are only applicable to the plans within the respective product family. If the same addons, charges, and coupons are required for plans in other product families as well, you have to create them again in the respective product families.
  • By creating the same addons, charges, and coupons in multiple product families, the reports reflect the consumption of these addons, charges and coupons split across different product families. If you require consolidated reports on their consumption, we suggest that you manage all your plans, addons, charges and coupons within a single product family.
Was this article helpful?