Getting Started

Building Blocks

Subscription Features

Custom Fields




Order Management

Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery


Self-Serve Portal


Reports and Analytics

Data Privacy & Security

Fraud Management


Other Features


Third Party Integrations

Trial Period for Addons 


Along with the service/product that you're offering, additional features will bring more traction. These supplementary features can be provided at an appended cost and are known as Addons. With Chargebee you can provide addons for trial to your customers, so your customers know the feature before signing up for it.

Say, with your service you provide Google Calendar as an addon. For the customers who are interested in signing up, they can use the Google Calendar feature for a limited number of days as a trial before using it along with the subscription.


To enable this feature for your site, contact [email protected] .

Configure Trial Period for Addons 

Trial period for addons is available only via API . You can save the details of the addon's trial period in the metadata of the addon.

Invoice for Addons on Trial 

At the end of the trial period, the addons will move to Active state. When it does, a separate invoice is generated for the addon.
From the date of activation to the date of subscription renewal, a prorated charge will be generated for the addon.

Say, for a subscription with a billing cycle from January 15 to February 15, an addon was added as a trial on January 20 for 10 days. The addon will activate on January 30 and an invoice with a prorated charge will be raised for January 31 to February 15.

If the customer's subscription renews on the same day as the addon is activated, they will receive two invoices, one for the subscription and the other for the addon, irrespective of the number of addons.

Say, the customer has a subscription and has 3 addons on trial. Subscription renews on the same day as the addons become activated. The customer will receive 4 invoices, one for the subscription renewal and the other 3 for the addons.


A separate invoice will be generated at the end of add-on trial even when Consolidated Invoicing is enabled for your Chargebee site.

Subscription Cancellation and Reactivation (Dunning) 

When subscriptions are canceled due to the dunning rules that are set, addons on trial will follow suit.
However, there are two scenarios to be taken into account during the reactivation of the subscription:

1. In-term Reactivation

If the subscription is reactivated before the renewal date/time of the subscription, then the addon will continue to function upon reactivation. There will not be a change in the trial end date/time set originally.

Say, the billing cycle for subscription is from January 15 to February 15. Subscription got canceled on January 30 and reactivated on February 10.
There are two addons, Addon 1 and Addon 2, linked to the subscription and are on trial for 15 days.

Addons Trial Period Will the addon be on trial when the subscription reactivates? Charge on reactivation
Addon 1 January 20 - February 5 No Prorated charge from February 5 - February 15
Addon 2 January 27 - February 12 Yes No charge, the addon is still on trial.

2. Out-of-term Reactivation

If the subscription is reactivated after the date/time of renewal, the term of the addon will be reset and the trial will be no longer applicable. The customer will have to pay for the subscription and the addons, regardless of the completion of the trial period.

Say, the billing cycle for subscription is from January 15 to February 15. Subscription got canceled on February 12 and reactivated on February 22.

Addons Trial Period Will the addon be on trial when the subscription reactivates? Charge on reactivation
Addon 1 February 5 - February 20 No Full
Addon 2 February 10 - February 25 No Full

For both the addons, a full charge will be raised on the date of reactivation of subscription.


If Calendar Billing is enabled for your site, the charge can be prorated from the date/time of reactivation to the upcoming billing date/time.

Subscription Cancellation/Reactivation (Manual) 

When a subscription is canceled manually, the subscription term is not retained. The addons on trial linked to the same subscription will be canceled.

When the same subscription is reactivated, the subscription as well as the addons will move on to Active state and will be charged in full.


  • Recurring addons alone can have trial period added to them. Non-recurring addons are not supported.
  • Addons with a trial period can be added only for Subscriptions in Active state.
  • Once set, the trial_end of an addon cannot be modified. In order to modify, the addon need to be removed and added again with new trial_end.
  • When the addon is going through the trial period, values of all fields, except for trial_end value, can be modified.
  • Addons going through the trial period will move to Active state only when the trial period ends.
  • The changes for the addon will be applied immediately and cannot be scheduled for the end of term of the subscription.
  • For Advance Invoicing, addon on trial feature will not function.
Was this article helpful?