Welcome to Zuora Product Documentation

Explore our rich library of product information

Add a new feature

Learn how to add a new feature, configure its type, quantity, policies, and parameters, and manage entitlements in the Features page.

  1. Navigate to Products > Catalog
  2. Click Manage Features.

    The Features page displays:

    • Usage summaries that show the most frequently used features and the distribution of feature types.

    • Search and filter controls for locating features.

    • A table of existing features with their name, type, default quantity, unit of measure, tags, and associated products.

    • Actions to create, edit, and delete features.

    The usage summaries and feature list reflect the data in your tenant. The table displays the feature type as a label, such as NUMBER, and displays the unit of measure as a label, such as EACH. The feature name is shown with its feature code, and the default quantity is shown for each feature. The names and counts in the summary cards and table are example tenant data and can vary.

  3. Click Add Feature.
  4. Enter the following details:

    Field

    Description

    NameEnter a unique name to identify the feature.
    TagsEnter one or more tags to categorize and organize the feature.
    Type

    Select the feature type. Supported types include Metered, Unmetered, Boolean, and Enum.

    • Number - Represents a numeric value that is not usage-based. Use this type when you want to store or assign a configurable numeric quantity without tracking consumption.

      • Metered - Represents a quantity that is consumed over time and resets at the beginning of each billing cycle. Usage can be reported through mediation, usage upload files, or APIs, and is deducted from the entitlement balance.Examples include API calls, storage (GB), minutes, or seats. Metered features support units of measure, quantity limits, and usage policies.

      • Unmetered - Grants a fixed quantity that remains available throughout the subscription unless updated through APIs. Unlike metered features, unmetered features do not track consumption. When you add an unmetered feature to a rate plan, you can use the default quantity and policy or override them for that rate plan.

    • Boolean - Grants or denies access to a feature by using a true or false value.

    • Enum - Allows you to define a predefined set of permitted values for the feature.

    The following fields are displayed when Number (Unmetered) is selected from the Type drop-down list.
    Default QuantitySpecify the default quantity granted when the feature is assigned to an entitlement. Applies to quantity-based feature types.
    Unit of MeasureSpecify the unit used to measure the feature quantity, such as GB for storage.
    Min QtySpecify the minimum quantity that can be granted for the feature.
    Max QtySpecify the maximum quantity that can be granted for the feature.
    Policy

    Select the policy that determines how the entitlement behaves when it reaches its configured limit. Supported policies include Hard Block, Allow, Warning, and Custom Policy.

    • Hard Block - Prevents further access or consumption after the maximum entitlement is reached.

    • Allow - Allows continued usage even after the maximum entitlement is reached.

    • Warning - Generates a notification when configured entitlement thresholds (for example, 80% or 100%) are reached.

    • Custom Policy - Create a custom entitlement policy by describing the desired behavior in natural language. The AI assistant generates the policy implementation, which you can review and modify before applying it.

    Metric

    Select the entitlement metric that records and measures usage for the metered feature. The selected metric is used to measure consumption and apply the configured entitlement policy.

    This field is applicable only to Number (Metered) features.

    The following field is displayed when Enum is selected from the Type drop-down list.
    Allowed ValuesEnter the valid values for the enum feature as a comma-separated list. Only the specified values can be assigned to the feature.
    The following fields are common for all values selected in the Type drop-down list.
    Requires Activation

    Specifies whether the entitlement remains in the Pending state until it is activated.

    When an order creates an entitlement that requires activation, the entitlement is created in a pending state. The entitlement remains pending until your provisioning process updates its status to indicate that the feature is ready. You can perform the activation through an API or from the Entitlements Dashboard.

    Use this configuration for features that require an external fulfillment step, such as assigning a device, enabling a service, or completing an account setup process.

    Parameters

    Parameters are metadata associated with an entitlement. Use parameters to pass provisioning information that can vary for each customer or grant.

    For example, a medical device feature might include a device model parameter. A device feature might also include a color parameter with values such as beige, white, or black.

    You can:

    • Define parameters on the feature.

    • Override parameter values when an entitlement is granted.

    • Update parameter values during the entitlement lifecycle.

    • Use parameter values in your provisioning process.

    Define parameters only for information that is needed to provision or manage the entitlement. Do not use parameters as a substitute for the entitlement quantity, unit of measure, or usage balance.

  5. Click Add Feature.