Configure Entitlements

BETA

This feature is currently in beta and may change over time. During the beta period, functionality, availability, and performance may vary.

To join the Beta program, request Beta access.

Configure entitlements in Advanced Billing to define the features, usage limits, and service levels included with each Plan, Product, and price point. Use entitlement values to keep subscription access, customer-facing limits, and API-driven integrations aligned with what each subscriber has been granted.

Configuration checklist

Before using entitlements in production, confirm the following:

• Entitlements is enabled for your site.
• Feature templates are created for each capability you want to track.
• Each feature template has the correct kind (access, limit, or service right).
• Features are attached to the relevant Plans or Products.
• Each price point has the correct entitlement values configured.
• Custom price point entitlement values have been set where pricing tiers differ.
• Entitlements appear correctly on a test subscription.
• Your integration reads entitlements from the API as expected.

Enable entitlements

Entitlements must be enabled for your site before you can configure or view them.

Contact your Customer Success Manager or Maxio Support to request activation.

Once enabled, entitlement configuration options appear in the Plan and Product editors, and an Entitlements tab appears on each subscription.

Define features

Features are the individual capabilities or limits you want to track. Define them once in your feature catalog and reuse them across any Plan or Product.

To create a feature

1. Go to Catalog > Features.

2. Click New Feature.

3. Complete the Feature Fields.

   Field	Description
   Name	The display name shown to merchants and in API responses (e.g., “API Calls per Month”).
   Lookup Key	A stable, unique identifier used in API responses (e.g., api_calls_per_month). Cannot be changed after creation.
   Kind	Controls how the feature value is interpreted. Cannot be changed once the feature is attached to a Plan or Product. See Feature kinds below.
   Value type	The data type for the feature value: Text, Boolean, or Numeric.
   Unit	For usage limits only. The unit label shown alongside the value (e.g., “calls”, “GB”, “seats”).
   Default value	The value pre-filled when attaching this feature to a Plan or Product.
   Default reset period	For usage limits only. The interval and unit the limit resets on (e.g., every 1 month, every 3 hours).
   Description	Optional internal context for your team.

4. Choose the kind that matches the nature of the capability.

   Kind	Use when	Example
   Access	The feature is a boolean on/off capability.	SSO integration, priority support, custom domain
   Limit	The feature is a numeric quota that resets on a cadence.	10,000 API calls per month, 50 GB storage
   Service Right	The feature defines a service level or tier that does not reset.	99.9% SLA, dedicated infrastructure, response time guarantee

5. Click Save Feature.

Attach features to plans and products

Once features are defined, attach them to the Plans and Products that grant them. Each attachment is called a feature catalog item and stores the specific value a subscriber receives.

To attach features to Plans

1. Edit an existing Plan or create a new one.
2. Click the Entitlements tab.
3. Click Add Feature.
4. Select a feature from your catalog.
5. Enter the value granted by this Plan (e.g., 10000 for 10,000 API calls).
6. For usage limits, confirm or adjust the reset period.
7. Click Save.

The values you set here become the default entitlements for all price points on this Plan. You can override individual values per price point. See Configure price point entitlements.

To attach features to Products

1. Open a Product.
2. Scroll to the Entitlements card.
3. Click Add Feature.
4. Select a feature and enter a value.
5. Click Save.

For quantity-based Products, the entitlement value reflects what a single unit of the Product grants. If a subscriber allocates multiple units, the resolved entitlement on the subscription aggregates accordingly.

Configure price point entitlements

Each price point inherits the default entitlement values set on the Plan or Product. You can override any value for a specific price point to reflect tiered pricing.

To override entitlements on a price point

1. Open the Plan or Product.

2. Go to Price Points and open the price point.

3. Click the Entitlements tab.

4. Check Override Default Entitlements for this Price Point.

5. Adjust any feature values as needed.

6. Click Save.

   

Changes to a price point’s entitlement values apply to new subscriptions on that price point. Existing subscriptions are not automatically updated. To update existing subscriptions, see Propagate entitlement changes.

Related information

See Understand Entitlements to learn the concepts behind features, feature kinds, and default and overridden entitlement values.

See View and Update Subscription Entitlements to review resolved entitlement values on subscriptions and update existing subscriptions after entitlement changes.

See Read Subscription Entitlements with the API to retrieve resolved entitlement values for application access control and feature gating.

See Troubleshoot Entitlements to resolve missing, outdated, or unexpected entitlement values.