Documents

Add a new Attribute

Last Modified Dec 9, 2025

  1. Navigate to Taxonomy > Attributes in the main menu.
  2. Click Create.
  3. Enter the attribute Code.
i

The Attribute Code must be unique within the site.
Only alphanumeric characters (a-z, A-Z, 0-9), hyphens (-), and underscores (_) are allowed.

  1. Select the attribute Type.
    • allowed types are:
      • Text: the value will be any sequence of characters. e.g. Brand
      • Number: the value will be any number, e.g. Weight.
      • List: the value will be a Text, selected from a defined list, e.g. Size: XS S M L XL
      • Yes / No: usually for a flag, values can be only yes or no, e.g. Include batteries
  3. Enter the attribute Title as a short description of the attribute.
  4. Enter the attribute Description.
  5. Select the Attribute Families, if the attribute will be grouped in one or more Attribute Families.
  6. Check/Uncheck the attribute flags:
    • Searchable, if the attribute can be use for searching function.
    • Filterable, if the attribute can be used in the filters.
    • Sortable, if the products can be sorted by this attribute.
    • Unique, if there cannot be duplicated values for this attribute.
    • Translatable, if the attribute can be translated.
  8. Set the Validations if apply
    Some of the fields type may require a validation.
    • Text fields validations:
      • Minimum Length of the possible values.
      • Maximum Length of the possible values.
      • Pattern as regular expression.
      • Enumerated as a list os all the possible values that the field can take.
    • Number fields validation:
      • Minimum value the field can take
      • Exclusive Minimum, if true, minimum will NOT be included as a possible value.
      • Maximum value the field can take
      • Exclusive Maximum, if true, maximum will NOT be included as a possible value.
  10. Set the Options if apply
    • For List field types, the available options for the field must be provided. Create a new option with the Add button and set the Code and Title.
    • Click on [✓] to keep the changes or [x] to discard them.
    • Options can be edited using the Edit icon, or removed with the Delete icon.
  12. Set the Dependencies if apply
    Product attribute dependency means that an attribute becomes relevant only if a specific value of another attribute has been selected.
    • Create a new Dependency with the Add button
      • Find the Attribute upon which the current one will depend. This attribute will be called primary or independent.
      • Select an Operator, possible values are:
        • equal to: it means that te value in the primary attribute should be equals to a specific value to make the dependent attribute relevant.
        • include in: it means that te value in the primary attribute should be within a list of specific value to make the dependent attribute relevant.
      • Enter the Value. Value will be a single text or number if the operator is equals to and a list of arguments if the operator is include in.
    • Click on [✓] to keep the changes or [x] to discard them.
    • Dependencies can be edited using the Edit icon, or removed with the Delete icon.
i

If there are multiple defined dependencies, each one must be valid (true) for the dependent attribute to be considered relevant.

  1. When all the changes were made, click on the Save button, or on Discard to reject the updates.


← Attributes Overview
Import a List of Attributes →