Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Currently, this feature is in EAP. Please write to eap@chargebee.com to get this enabled.

Entitlement Versions

Entitlement versions track changes to entitlements applied to features of items or item prices. A new version of the entitlement is created whenever it's added or updated with grandfathering enabled. In other words, this applies when the change is intended only for new subscriptions. This versioning system ensures accurate entitlement calculations for subscriptions based on when they were created.

How Versions Work

  • Version Creation: A new version is created each time an entitlement is added or updated for an item or item price and applied to all new subscriptions.

  • Subscription Applicability: The latest version is applied only to subscriptions created after the version's effective date.

  • Entitlement Calculation: The total entitlement value for a subscription is calculated using the version of each entitlement applicable at the time of subscription creation.

Viewing Entitlement Versions

You can view entitlement versions from the Features page:

  1. Navigate to Entitlements, and click Features.
  1. Select a feature for which you want to view the entitlement versions.
  1. Under Entitlement Version, click View. The version details will be displayed, including:
    • Feature name
    • Item and Item Price
    • Creation and modification timestamps
    • Entitlement values
    • Reason for change
    • Current and applicable package version

Was this article helpful?