Product Entitlements
Product entitlements map features to Rate Plans and Addons with specific values. This defines what each catalog item includes and at what level — forming the basis for subscription entitlement resolution.
How Product Entitlements Work
When you attach a feature to a rate plan or addon, you specify the entitlement value for that feature type:
| Feature Type | Value You Set | Example |
|---|---|---|
| Switch | On or Off | SSO: On |
| Quantity | A numeric value | API Calls: 10,000 |
| Range | Min and Max values | Storage: 1 – 100 GB |
| Custom | A level from the defined list | Support: Phone Support |
These values are used during entitlement resolution when a customer subscribes.
Attaching Features to a Rate Plan
- Navigate to Products > {Product} > Rate Plans and select a rate plan.
- Scroll to the Entitlements section.
- Click Edit.
- Click + to add features to the rate plan.
- For each feature, set the entitlement value based on its type:
- Switch — Toggle on or off.
- Quantity — Enter a numeric value.
- Range — Set min and max values.
- Custom — Select a level from the dropdown.
- Click Apply to save.
Attaching Features to an Addon
The process is the same as for rate plans:
- Navigate to Products > {Product} > Addons and select an addon.
- Scroll to the Entitlements section.
- Click Edit.
- Add features and set values.
- Click Apply to save.
Modifying Product Entitlements
- Navigate to the rate plan or addon’s Entitlements section.
- Click Edit.
- Modify values, add new features (+), or remove existing ones.
- Click Apply to save.
Important: Changes to product entitlements affect both new and existing subscriptions. When entitlements are re-resolved (e.g., on renewal or manual re-resolution), the updated values from the catalog are used.
Entitlement Aggregation Example
Consider a customer subscribed to the Professional Plan with the Extra API Calls Addon:
| Feature | Type | Plan Value | Addon Value | Resolved Value |
|---|---|---|---|---|
| SSO | Switch | On | — | On |
| API Calls | Quantity | 10,000 | 5,000 | 15,000 |
| Storage | Range | 1–50 GB | 0–25 GB | 1–75 GB |
| Support | Custom | Chat Support | Phone Support | Phone Support |
The resolved values become the customer’s subscription entitlements. See Subscription Entitlements for how to view and override these.
Viewing Entitlements from the Feature Side
You can also view and manage product entitlements from the feature’s detail page:
- Navigate to Products > {Product} > Features and select a feature.
- The feature detail page shows all rate plans and addons that have this feature attached, along with their entitlement values.