Skip to main content
Features represent the product capabilities, access rights, or usage limits that customers receive outside of billing. They help your team track what each customer is entitled to use, based on the products they have and any customer-specific override. Use features when you need to manage access such as SSO, premium integrations, included seats, API limits, or support tiers. Products still define what you sell and bill. Features define what access or limit that product grants.

How entitlements are resolved

An entitlement is the resolved value of a feature for a customer. Hyperline calculates it from three possible sources:
SourceDescription
Default valueThe fallback value configured on the feature in the catalog. Optional — features can be created with no default.
Product grantA value granted by a product included in the customer’s eligible subscription.
Customer overrideA value set directly on the customer. Overrides product grants and the default value.
Customer overrides always take priority. If no customer override exists, Hyperline uses product grants. If no product grant changes the value, Hyperline uses the default value from the feature catalog. Product grants contribute to entitlements when the subscription that includes the product is active or paused. Paused subscriptions keep product-granted access, while other subscription statuses do not contribute product grants.

Features without a default value

Specifying a default is optional. A feature can be created with no default value for both boolean and number types. When a feature has no default:
  • Customers receive no resolved entitlement unless a product grant or a customer override provides one.
  • No source is displayed for the feature on the customer Features tab until a grant or override is set.
  • Use this when access should be explicitly granted per product or per customer rather than assumed by default — for example, a beta capability that only certain plans or customers should ever see.

Example 💡

A HubSpot integration feature has a default value of disabled. The Growth plan product grants the feature as enabled. Customers subscribed to Growth receive the integration automatically, while a customer override can still enable or disable it for a specific customer.

Feature value types

Features can use two value types:
TypeUse forExample
BooleanAccess that is enabled or disabled.SSO, premium support, white-labeling, HubSpot integration.
NumberLimits, quotas, or numeric entitlements.Included seats, API calls, projects, storage in GB.
Boolean features do not require a resolution strategy. If a product grant enables the feature, the customer receives access unless a customer override changes the value. Number features use a resolution strategy to combine the default value and product grants.
ResolutionBehaviorUse when
MaximumUses the highest value across the default value and product grants. Customer overrides win.Multiple products can increase a limit, but the customer should receive only the largest grant.
SumAdds the default value and product grant values. Customer overrides win.Multiple products should stack together, such as included seats or usage quotas.
ReplaceUses a product grant value instead of the default value. Customer overrides win.A product should define the entitlement value directly.
When a number feature has no default value, resolution falls back to the product grants and customer overrides only. Maximum and Sum ignore the missing default and compute across product grants alone, and Replace uses the product grant value directly.

Create a feature

  1. Go to Catalog > Features.
  2. Click New feature.
  3. Enter the feature Name and, if needed, an Internal description.
  4. Enter a stable Code. Use an API-safe key such as sso, hubspot_integration, or included_seats.
  5. Choose the value Type:
    • Boolean for enabled or disabled access.
    • Number for quotas or limits.
  6. For number features, choose the Resolution strategy.
  7. Optionally toggle Default value on and set the value. Leave the toggle off to create the feature with no default — customers will only receive an entitlement when a product grant or override provides one.
  8. Click Save feature.
Use codes that match how your product team refers to access internally. Stable codes make reporting and integrations easier to maintain.

Grant features from products

After a feature is created, add it to the products that include that capability or limit.
  1. Go to Catalog > Products.
  2. Open the product that should grant the feature.
  3. In Entitlements, click Add feature.
  4. Select the feature from the catalog.
  5. Keep the default value or open the row to set a product-specific value. If the feature has no catalog default, you must provide an explicit value for the product grant to save.
  6. Click Save.
When the product is included in a customer’s eligible subscription, its feature grants contribute to that customer’s resolved entitlements.
Entitlements do not create invoice lines or change the product price. They describe access granted by products that are already billed through subscriptions, quotes, or invoices.

Review customer entitlements

Open a customer page and select the Features tab to see the resolved entitlements for that customer. Each row shows the feature name, resolved value, and a tag indicating where the value comes from:
TagMeaning
DefaultThe value comes from the feature catalog.
ProductThe value is granted by one or more of the customer’s subscribed products. Hover the tag to see which subscriptions contribute.
OverrideA customer-specific value is applied on top of product grants and the default.
The Features tab is available to members with the entitlements_update permission on workspaces that have entitlements enabled.

Override a customer entitlement

Use customer overrides for exceptions that should apply only to one customer, such as a negotiated limit, an early access grant, or a support-approved exception.
  1. Open the customer page and select the Features tab.
  2. Find the feature in the table and open the row’s action menu.
  3. Click Edit to open the override modal.
  4. Update the Value and, optionally, add a Reason to record why the override exists.
  5. Click Save.
To remove an override and let Hyperline recalculate the value from product grants and the feature default, open the row’s action menu and click Reset.

Grant a feature to a customer

You can also grant a feature directly to a customer, even if no subscribed product includes it.
  1. Open the customer page and select the Features tab.
  2. Click Grant feature and pick a feature from the picker.
  3. Set the Value and, optionally, a Reason.
  4. Click Grant feature.
The granted feature appears in the table with the Override tag and behaves like any other customer override.
Customer overrides are customer-specific exceptions. Use them when the customer should intentionally differ from the product configuration.

Next steps