Entitlements

Plans supporting this feature: Scale

Define perks, privileges and benefits that your customers have access to as part of their plan, add-on or subscription, e.g. offering basic, professional and enterprise models.

Entitlements can be configured at a Plan and Add-On level.

They can be additional added or removed for a user at a Subscription level.

Create Entitlements

1. Create, edit and delete Entitlements from Configurations > Product catalogue >  Entitlements.
   
   

2. Create new Entitlements by clicking on the New button on the top right-hand side.

   While creating an entitlement, you can define the Name, Handle and the Description of the entitlement.

   💡 Tip

   Use clear, consistent handles (e.g., 4k-streaming, max-products, max-members) - your development team will use these handles to check entitlements programmatically in your application.

   
   

Add Entitlements to a Plan

Entitlements can be added to a plan

• while creating the plan

• by editing it

To add entitlements to an existing plan click on Actions while editing a plan and then click on Supersede.

1. Scroll down and click on Add additional configuration.

2. Click on Entitlements and Confirm.

3. Now you can add the entitlement.
   

Add Entitlements to an Add-On

Similarly Entitlements can be added to an Add-on while creating the add-on or by editing it.

Existing add-ons can be edited and the entitlement can be added to it directly.

Add Entitlements to a Subscription

Add entitlements to a subscription during creation or you can add entitlements later to it from the Subscriptions details page.

For an ongoing subscription, the entitlements can be added from the Subscriptions details page. Here you will be able to see the Entitlements inherited from Plans and Add-ons and the ones added explicitly to the subscription under two separate tabs.

Use cases

1 Controlling Team Size with max-members

You offer three plans: Starter, Business, and Enterprise. Each plan allows a different number of team members to access the platform.

• Starter includes: max-members (up to 5)

• Business includes: max-members (up to 25)

• Enterprise includes: max-members (unlimited)

When a company subscribes to the Business plan, they can invite up to 25 team members. If they need more seats, they either upgrade their plan — or you offer a "Extra Seats" add-on with an additional max-members entitlement, allowing them to extend their limit without a full plan change.

You can also grant a specific customer more seats directly at the subscription level, for example during a negotiated enterprise deal, without touching the plan itself.

2 Managing Streaming Quality with 4k-streaming

You offer a video streaming platform with two plans: Standard and Premium.

• Standard includes: max-simultaneous-streams (1), no 4k-streaming

• Premium includes: max-simultaneous-streams (4), 4k-streaming

A subscriber on the Standard plan contacts support asking for 4K access for an upcoming event. Instead of asking them to upgrade their full plan, you add the 4k-streaming entitlement directly to their subscription for the duration of the event — then remove it afterwards. Their billing stays unchanged.

This is also a powerful tool for free trials of premium features: you temporarily grant 4k-streaming to a Standard subscriber to give them a taste of the Premium experience, with the goal of converting them to an upgrade.