Managing Item Price Entitlements

Chargebee allows you to manage entitlements at the item price level. Item price entitlements let you set a different entitlement value for each price of a plan or addon, such as its monthly and yearly prices, instead of one value for the whole item. An entitlement set on an item price takes precedence over the entitlement set on its item.

Benefits of Using Item Price Level Entitlements

• Greater Flexibility in Packaging: With item price entitlements, you can set different entitlement values for specific price points of an item. This provides greater flexibility, allowing you to tailor entitlements to the unique requirements of individual plan or addon price points.
• Prevents Over-Allocation: With item price entitlements, allocate feature values precisely for each unique price point, avoiding excess provisioning.
• Granular Customization for Upselling: You can customize with precision, allowing you to upsell and cross-sell additional services or features, maximizing revenue potential.

Item price entitlements for metered and non-metered features

What the entitlement value on an item price means depends on the kind of feature:

• Non-metered feature: The value is the access that the price gives the customer. Your application enforces the value, and it doesn't affect invoices.
• Metered feature: On a plan price or a non-metered addon price, the value is the included usage for that price: how much the customer can use before usage counts as overage. When the subscription has a metered addon for the feature, the addon charges for the overage, so included usage affects invoices. By default, metered addons have unlimited entitlements, which don't count toward the included usage.

An entitlement set on an item applies to all prices of that item. To give each price, such as a monthly and a yearly price, its own included usage of a metered feature, set the included usage on each item price. When you link pricing for a metered feature, you set the included usage for each frequency of the linked plans and non-metered addons.

To change the entitlement of an item price for one subscription, override it on that subscription. For a metered feature, this is the only way to change the included usage of a single subscription. See Item Price Entitlement Overrides.

Prerequisites for item price entitlements

To manage item price entitlements, make sure you have created a feature, created an item (plan or addon), and set prices for different billing frequencies.

Adding Item Price Level Entitlements

You can add Item Price Entitlements in one of the two ways:

• Using the Item Price Details Page

• Using the Feature Details Page

Using the Item Price Details Page

1. Go to the Product Catalog > Item Price Point > Select an Item and scroll to the Entitlements card > Click Add/Edit Feature.

   

2. On the Entitlements page of this Item Price Point, you will find a list of features in the left pane.

   

3. Add features from the left pane to the right side by clicking the + icon. You can also set specific entitlement levels by editing the Entitlement Level of each feature.

   

4. Once you have added the features and their entitlement levels to the Item Price Point, decide on one of the following actions:

   • Click Apply > Confirm to save and update the entitlement levels for this Item Price Point. This will replace any previous settings at the item level.

     

   • Click Dismiss if you want to keep the previous settings and ignore any new changes.

Using the Feature Details Page

1. Log in to Chargebee > Entitlements > Choose a specific feature. Click on the Edit Item Price Entitlements in the Features Detail page.

   

2. On the Edit Item Price Entitlement page, you will find a list of item prices on the left pane. You can move these item prices to the right pane and set the specific entitlement levels for each.

   

3. Add item prices from the left pane to the right side by clicking the + icon. When an item price is added from the left pane, it appears under the "Plan Price/Addon Price" row on the right pane.

   

4. After moving an item price to the right pane, you can set an entitlement value at the item price level. If you move an item to the right pane without any of its item prices, the entitlement value is set at the item level. This means the same entitlement value at the item level applies to all subscriptions for item prices where the entitlement value isn't explicitly defined.

   

5. Once you have set the entitlement levels, decide on one of the following actions:

   • Click Apply > Confirm to save and update the entitlement levels for the item price. This will replace any previous settings at the item level.

     

   • Click Dismiss if you want to keep the previous settings and ignore any new changes.

6. Additionally, you can set the entitlement value to be greater than, less than, or equal to the entitlement value defined at the item level for that feature.

7. View the updated entitlements in the Availability section of the Feature Details page. Price point level updates are shown under new rows labeled Plan Prices and Addon Prices, both in the Availability and All sections.

   

Modifying Item Price Level Entitlements

You can modify Item Price Entitlements in one of the two ways:

• Using the Item Price Details Page

• Using the Feature Details Page

Using the Item Price Details Page

1. Go to the Product Catalog > Item Price Point > Select an Item and scroll to the Entitlements card > Click Edit.

   

2. On the Entitlements page of this Item Price Point, you will find a list of features in the left pane. You can edit the feature entitlements and set values at an item price level. You can input an entitlement level value that is greater than, less than, or equal to the entitlement value defined at the item level for that particular feature.

   

3. Once you have modified the features and their entitlement levels to the item price point, decide on one of the following actions:

   • Click Apply > Confirm to save and update the entitlement levels for the price point. This will replace any previous settings at the item level.

     

   • Click Dismiss if you want to keep the previous settings and ignore any new changes.

Using the Feature Details Page

1. Log in to Chargebee > Go to Entitlements > choose a specific feature. Click on the Edit Item Price Entitlements in the Features Detail page.

   

2. On the Edit Item Price Entitlement page, you will find a list of item prices on the left pane. You can edit the entitlement level of the already-added item prices. When you make changes to entitlement values at the item price point level, those modifications are applied, taking precedence over entitlement values at the item level.

   

3. Once you have modified the item prices and their entitlement levels, decide on one of the following actions:

   • Click Apply > Confirm to save and update the entitlement levels for the item price point. This will replace any previous settings at the item level.

     

   • Click Dismiss if you want to keep the previous settings and ignore any new changes.

4. After you have completed modifying the item prices, you should see the changes reflected in the availability section of the feature details page. The updated item price value will appear under the Plan Price or Addon Price row in both the Availability section and the All section of the feature details page.

Deleting Item Price Level Entitlements

You can delete Item Price Entitlements in one of the two ways:

• Using the Feature Details Page

• Using the Item Price Details Page

Using the Item Price Details Page

1. Go to the Product Catalog > Item Price Point > Select an Item and scroll to the Entitlements card > Click Edit.

   

2. On the Entitlements page of this Item Price Point, you will find a list of features in the left pane. You can click the x button to remove a specific feature or click Remove All to remove all the features. When you remove a specific feature from the right pane, it won't be displayed there anymore. However, you retain the ability to add the removed feature again if needed, and you can do this from the left pane.

   

3. Once you have removed the features, decide on one of the following actions:

   • Click Apply > Confirm to save and update. This will replace any previous settings at the item level.

     

   • Click Dismiss if you want to keep the previous settings and ignore any new changes.

Using the Feature Details Page

1. Log in to Chargebee > Go to Entitlements > choose a specific feature. Click on the Edit Item Price Entitlements in the Features Detail page.

   

2. On the Edit Item Price Entitlement page, you will find a list of item prices on the left pane. You can click the x button to remove a specific item price or click Remove All to remove all the item prices. When you remove a specific item price from the right pane, it won't be displayed there anymore. However, you retain the ability to add the removed item price point again if needed, and you can do this from the left pane.

   

3. Once you have removed the item prices, decide on one of the following actions:

   • Click Apply > Confirm to save and update. This will replace any previous settings at the item level.

     

   • Click Dismiss if you want to keep the previous settings and ignore any new changes.