Welcome to Zuora Product Documentation

Explore our rich library of product information

Add a new attribute

Learn how to add a new attribute in Extension Studio by navigating through the interface and entering the required details.

  1. Navigate to Extension Studio > Context& Attributes.
  2. Click Add Attribute. A form on the right appears.
  3. Enter the following details:
    FieldDescription
    NameThe unique name for the attribute, for example, planType, region, termLength.
    CategoryThe logical group for the attribute. Select the required option from the drop-down list.
    Object Type

    The object type. Select one of the following:

    • Standard Object - Choose from built-in Zuora objects like Account, Subscription, RatePlan, and so on.
    • Custom Object - Use this to map to a custom object you've created in Zuora.
    Source

    Defines where the data comes from. Select one of the following:

    • Zuora - The value is fetched from a Zuora standard or custom object.
    • External - The value is provided from an external source. When External is selected:
      • Attribute Type dropdown appears with options: Boolean, String, Number.
        • If String is selected, a Values field appears to define the allowed string values.
        • If Number is selected, the Minimum Value and Maximum Value fields appear to define numeric limits.
      • External URL field appears to provide a reference or integration link.
    Source ObjectThe specific Zuora object where the attribute resides. The Source Object drop-down contains both standard Zuora objects and any custom objects created in your tenant.
    Field Mapping

    Displays a list of fields from the selected Source Object. The list updates dynamically based on the chosen object.

    Enter values as prompted, depending on the field type:

    • For String: Enter one or more values in the Values field.
    • For Date / DateTime: Select appropriate dates or date ranges.
    CRM MappingIf the attribute maps to a CRM field (like Salesforce or another external system), enter the exact CRM Mapping Key here.

    This allows the system to sync data correctly with the external source.

    For details about CRM field mappings in Zuora CPQ, see Dynamic Pricing with CRM-mapped attributes using DSL.

  4. Click Save.