Introducing the Chargebee CLI

Entitlements Overview

Save time with Catalog Setup Assistant

Let Chargebee AI draft product families, plans, addons, charges, prices, features, and entitlements from a pricing page, document, or description. Available on your test and sandbox sites.

Try Catalog Setup Assistant

Entitlements define what your customers get from the plans, addons, and charges they buy: which features of your product they can access, and how much of each feature they can use. In Chargebee, you represent each capability of your product as a feature, set entitlements for the feature on your product catalog, and Chargebee works out the entitlements of every subscription.

Every feature is either metered or non-metered, and the kind of feature decides what Chargebee does with its entitlements:

  • Metered features: Chargebee meters the usage events you send and applies the included usage from each subscription's plans and non-metered addons. When the subscription has a metered addon for the feature, the addon charges for usage beyond the included usage, so metered entitlements affect invoices.
  • Non-metered features: Chargebee stores the entitlements of each subscription and is the source of truth for them. Your application grants access and tracks usage. Non-metered entitlements don't affect invoices.

For both kinds of features, your application enforces access: it reads the entitlements from Chargebee and decides what each customer can do in your product.

Regardless of your business line, it is essential to configure entitlements if you want to:

  • Ensure that your users are accessing features that they're entitled to
  • Understand which of your features are driving value for your customers and revenue for your business
  • Leverage additional revenue opportunities
  • Increase revenue from upgrades and renewals
  • Minimize churn by cross-selling or upgrading based on customer expectations

Metered and non-metered features in Chargebee

Choose the kind of feature by asking whether you want Chargebee to meter consumption from usage events—either to charge for usage or to track usage against an included usage limit.

Create a metered feature when you charge for consumption or track consumption against an included usage limit, such as tokens, API calls, or storage. Chargebee calculates usage of the feature from the usage events you send, and one usage event can count toward several metered features. In Usage-Based Billing, only addons can be metered; plans and charges are always non-metered, and charges don't grant included usage. The entitlement you set on a plan price or a non-metered addon price is the included usage: how much the customer can use with that price before usage counts as overage. A non-metered addon, such as a top-up, adds to the included usage. Overage is usage beyond the included usage. A metered addon is an addon priced per unit of usage: when the subscription has one for the feature, it charges for the overage. A metered addon also has an entitlement to the feature, unlimited by default, but that entitlement doesn't count toward the included usage.

Create a non-metered feature when the feature controls access and its usage doesn't change the invoice, such as access to a module, the number of user seats a plan allows, or a support tier. Non-metered features have four types: switch, quantity, range, and custom. For a side-by-side comparison of the two kinds, see Compare metered and non-metered features.

Pricing setups for metered features

Metered features support these pricing setups:

  • Included usage plus overage: A plan price includes some usage, for example 1 million tokens a month, and a metered addon charges for the tokens used beyond it.
  • Pay as you go: A $0 plan holds the subscription, and a metered addon with an unlimited entitlement charges for all usage.
  • Included usage only: A plan price includes some usage, and the subscription has no metered addon. Chargebee tracks usage against the included usage, and your application limits use when the customer reaches it.

For worked examples of each setup, see Included Usage Billing and Overage Pricing Models.

Usage beyond the included usage of a metered feature

Chargebee keeps recording the usage events you send after a customer reaches their included usage. If the subscription has a metered addon for the feature, the addon charges for the overage. If it doesn't, the extra usage isn't charged, and your application decides whether the customer can keep using the feature.

To act at a threshold, such as notifying the customer at 80% of their included usage or offering an upgrade at 100%, set up usage alerts. Usage alerts send webhooks when usage crosses the percentage you set.

Entitlements Across Industries

Let's look at a few examples from different industries to better understand the concept of entitlements.

Developer Platform

A developer platform can include 1 million tokens and 10,000 API calls a month in its Starter plan, and charge for usage beyond them through metered addons. Tokens and API calls are metered features: Chargebee meters them from the usage events the platform sends and charges the overage on the invoice. Access to premium support is a non-metered switch-type feature that the Starter plan doesn't include.

SaaS Company

A SaaS company could offer three plans: Basic plan users only get email support and an SLA of three days; Standard plan users get email and phone support with an SLA of one day; Premium plan users get email, phone, and chat support with 24/7 always available support.

IoT Company

An IoT company specializing in security doors can offer three membership plans: Basic membership provides only the voice control feature; Standard membership provides break-in detection along with voice control; Premium membership provides automatic cop alert during break-in along with the two other features mentioned.

E-Learning Website

An eLearning website can offer three plans: Basic plan provides access up to 20 learning hours in a month; Standard plan provides access up to 50 learning hours; Premium plan provides access to 100 learning hours a month along with mentor support.

Publication Company

A news website can offer two plans: Basic plan provides access to ten articles and up to five videos per month; Premium plan provides unrestricted access to articles and videos.

Streaming Platform

An OTT streaming platform can offer three plans: Basic plan provides access to watch up to five movies per month in only one language; Standard plan provides access to watch up to ten movies a month in two different languages. Premium plan users could watch up to 40 movies a month in five different languages.

For a deeper dive, explore our comprehensive tutorials, including Getting Started with Entitlements and many more.

Set up entitlements in Chargebee

To set up entitlements, follow these steps:

  1. Decide whether each feature is metered or non-metered. See Metered and non-metered features in Chargebee.
  2. Create the feature:
    • Create a metered feature from Entitlements > Features > Create Feature by selecting Metered feature, or from Usages > Metered Features. See Defining Metered Features.
    • Create a non-metered feature from Entitlements > Features > Create Feature by selecting Non-metered feature. See Creating Features.
  3. Set entitlements for the feature on your product catalog:
  4. Activate each non-metered feature. A non-metered feature starts in the Draft state, and its entitlements take effect on subscriptions only after you activate it. See Activating Features.
  5. Check the entitlements of your subscriptions, and keep your application in sync with them. See Subscription Entitlements.