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:

   Field	Description
   Name	The unique name for the attribute, for example, planType, region, termLength.
   Category	The 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. Note: To use range operators in Dynamic Pricing CSV uploads, configure the mapped attribute with one of these data types: Number, Integer, Date, or DateTime. Attributes with unsupported data types, such as Boolean or String, support exact-match values only in CSV uploads. The out-of-the-box EffectiveDate column also does not support range operators. To upload range-based pricing conditions, define the attribute in Extension Studio > Context & Attributes before mapping it in the Upload pricing flow. External URL field appears to provide a reference or integration link.
   Source Object	The 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 Mapping	If 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.
   Note:

   If an attribute is already referenced by one or more Dynamic Pricing rate cards, Zuora locks the core definition fields for that attribute to prevent breaking existing pricing configurations. In this case, only the Values and CRM Mapping fields can be updated.

   Existing Dynamic Pricing rate cards continue to use the version of the attribute that existed when the rate card was created. Later updates to the attribute, including CRM Mapping changes, are not applied automatically to existing rate cards. To use the updated definition, create a new Dynamic Pricing rate card or add a new row within the existing rate card.