Getting Started

Building Blocks

Custom Fields

Subscription Features




Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery

Hosted Pages


Reports and Analytics

Data Privacy & Security

Fraud Management


Open Source Resources

Other Features

API Integration

Third Party Integrations


To sign up a new subscription, and to charge a customer, we need to know how much and how often to charge them. To do this, we need a Plan.

What constitutes a Plan? 

A Plan is made up of price and billing intervals which you would use to sell subscriptions and charge buyers.

Considering the various kinds of subscription packages you can offer, you can easily create multiple Plans to accommodate them. Let us consider the example of an online storage solution provider throughout this document:

For example, there will be some users who will buy storage space for personal use while others would buy it for their business. You can create a home plan that provides basic features and a professional plan encompassing the advanced features at a higher price.

Quantity Based Plans vs. Flat Fee Plans 

When creating Plans, you can specify the Plan's recurring charge model. There are two options:

  1. Per Unit
  2. Flat Fee

Per Unit

If the product offering is quantity-based, you can create your Plan using this option. You can specify the plan quantity during sign up through the hosted pages or when creating subscriptions using the API .

The quantity of a Subscription can always be changed if required, by updating the Subscription.

Flat Fee

Use this option to create Plans with a fixed price and for which the quantity will always be 1. You cannot add quantity for these Plans.

Can I add/edit plans after initial setup? 

There is no limit to the number of Plans you can create. You can keep adding Plans whenever you need them.

When editing an existing Plan that has no subscriptions linked to it:

  1. You can make changes to all the fields.
  2. Plans that have no subscriptions associated with it can be completely deleted and the Plan Name can be reused.

When editing a Plan that has subscriptions linked to it:

  • You can change the Plan Name, Invoice Name and Trial Period.

  • You can archive a Plan if you no longer need it but the Subscriptions that are linked to it would be retained.

  • No new Subscriptions can be added.

  • The Plan's status will be displayed as Archived.

To change the price of a plan that has subscriptions linked to it, check out the Edit the price of a plan that already has subscriptions section.

  • A Plan Name has to be unique. Even if a Plan has been archived, the name cannot be reused unless the Plan has been deleted.
  • If a Plan has been archived, existing subscribers will still continue to be renewed.
  • To change the price currency, go to Settings > Configure Chargebee > Currencies.

Deleting Vs. Archiving Plans 

Deleting and archiving depends on whether the Plan has any Subscriptions associated with it.

When you delete a Plan that has no subscribers, the plan is completely removed from the system and it will not appear on the list of plans either. You can reuse a deleted Plan's name to create a new Plan if needed.

When you delete a Plan that has existing subscribers then the Plan gets archived. This means that it is not completely removed but will be in archive mode and will appear on the list of Plans. Archiving will also prevent future usage of the Plan.

Creating a new Plan 

Creating a new Plan is quite simple. All you need to do is:

  1. Log into your web interface.
  2. Go to Product CatalogPlansCreate a New Plan.

Fill out the new Plan form with all the necessary details and you're all set.

What do I name my Plan? 

Naming a Plan (using the Name field) is mandatory, and it should be named in a way that is easily identifiable without having to go into the actual Plan to see the details.

Rather than naming Plans, Plan A, Plan B, it is quite convenient to name it say, Home Monthly/Yearly, Professional Monthly/Yearly, etc.

What is the ID field used for? 

The Chargebee API uses the unique Plan id and not the Plan name to identify the plans that are on your website. A plan ID is the unique identifier of the Plan and when a Subscription is created or updated via the API from your app/website, the "id" should be used to refer to the plan.

Here's a sample Curl API code:

Click here  to see our API.

Where is the invoice name used? 

This would appear on the invoices, hosted checkout page and the customer portal.

What is the plan description for? 

The description content you enter for the Plans are shown to your customers in the customer portal when they change their subscription.

What are the accounting fields for? 

The Accounting Information section helps Chargebee sync up with any accounting applications that you integrate with, like Xero and Quickbooks. Each of the accounting fields captures information that helps track product specific sales/revenue from an accounting perspective.

  • Accounting code: This field captures your Accounting systems' General Ledger Account code/name. When product information is synced to the Accounting system, the product specific information will be synced with this account as captured here. This is a mandatory field. You cannot proceed with accounting integration if this field is left blank.

  • Accounting category: The Accounting Category captures product specific additional metadata or categorization for reporting purpose in the accounting systems (such as regions you are selling to or branches you are selling from). It should be entered in the format: : (example: Region: North).

If you are using QuickBooks - you can enter one category (referred as Classes/sub-classes)

If you are using Xero - you can enter two categories, Accounting Category_1, Accounting Category_2 (referred as Tracking categories).

For information regarding these fields in API, refer the plans section in the API documentation .


These fields will not be available by default, you should enable these fields at Settings > Configure Chargebee > Billing Rules and select Enable Accounting Fields for integration.

Restricting plans in the Customer Portal 

To hide a plan from appearing for selection in the Customer Portal (during the Change Subscription operation), uncheck the option Display in Customer Portal in the Create New Plan/Edit Plan page:

Pricing and billing interval 

The Price field is used to specify how much you are charging the buyer for the particular plan.

Once you have set the price, you can set the billing interval using the Bill Every field. This determines how frequently the customer has to be charged.


Price: $50

Bill Every: 3 Months

This will charge the buyer at $50 every three months.

If it is a quantity based plan, then the price will be $50 * Quantity.


Price: $50

Bill Every: 3 Months

Subscribed Quantity: 5

The buyer will be charged $50*5=$250 every 3 months.

Can I add a onetime setup fee? 

Yes. Using Setup Cost (which is an optional field) we can setup a onetime fee along with the first payment.


If you provide a onetime installation support for the storage application suite, you can use
Setup Cost for charging the customer once during the sign up.

You could also use non-recurring Addons but to be able to do so, the plan should not have a trial period.

Can I make a certain Plan exempt from Taxes? 

You can choose to exempt a Plan from taxes by not selecting the This plan is subject to taxes checkbox while creating the plan. When the checkbox is selected, the plan becomes subject to taxes.

Setting subscription duration 

You can use the No. of Billing Cycles field to determine the subscription duration. If you leave this field blank, it will default to being charged until you or the customer cancels the subscription.

The billing cycle is used to set the number of recurrences for charging the customer.


You want to charge a customer on a quarterly basis for 1 year.

Bill Every: 3 Months

No. of Billing Cycles: 4

Subscription Ends after: 3 * 4 = 1 year

Total Charges Made: 4

I want to change the price of Plan that already has subscriptions? How can I do that? 

You can change the price of a Plan associated with Subscriptions. Chargebee supports changing the price of the plan itself (so that new subscribers are charged the updated amount) and changing the price of the plan for a particular subscription (so that the updated price applies to the relevant subscription alone).

Edit the price of a plan

To edit the price of a plan, navigate to Plans > [Plan Name] > Edit Plan. Enter the new price of the plan in the plan's pricing section at the bottom of the page.
This new price will not apply to its existing subscriptions but will apply to new subscriptions to the plan. All the other facets of the plan will remain exactly the same.

Override the price of the plan for a particular subscription

If you would like to change the price of a plan for a particular subscription or set of subscriptions Chargebee allows you to override the price of a plan.

Here's how you can customize the price of a plan to a particular subscription:

  • Navigate to the customer's' subscription details page and click the Change Subscription option listed under Actions.

  • On the Edit Subscription page, enter the new price in the Unit Price field and the quantity for which you'd like the new price to apply. You can do this for new subscriptions as well. All invoices for this subscription will be made with reference to this new price.

Can I copy details of an existing plan to a new plan? 

Yes, you can. If you would like to borrow from an existing plan to make a new one, you can make use of the Clone Plan option.

You can make the following changes using the Clone Plan option:

  • Changes related to the pricing and billing model.
  • Changes related to plan name and plan id.
  • Trial periods can be changed with this option.

To clone a plan, navigate to the plan you would like to copy and click the Clone Plan option.

How are free trials handled? 

Using the Free Trial field you can set the number of days an account can be in trial mode. Depending on the payment gateway you use, once trial days are over, the initial charge may go through. Read more.

How can I use free quantity? 

This option is available when you specify your plan's recurring charge model as Per Unit.

Free quantity is the amount of goods you would like to give to your customers at no extra charge. You or your customer can specify the total quantity of goods at the time of purchase.

This plan is only applicable for quantity-based plans.


If a customer is signing up for a special discounted plan that offers 10GB at no charge.

Price - $2

Free Quantity - 10 GB

Subscribed Quantity - 100 GB

Quantity Chargeable - 90 GB

Charged Amount = $2 * 90 = $180

So this customer will only be charged for 90 GB of storage space.

If the free quantity is more than the subscribed quantity, then the plan will be considered as a free plan, and the buyer will not be charged at all for their subscriptions. For the above example, if the subscribed quantity was 10 GB, then it would be a free plan.

Was this article helpful?