Attributes

This page explains how to create and manage custom attribute definitions for products, categories, companies, contacts, customers and clusters.

Before you begin

• You need the Configuration role to view this page.
• You need Owner access on the Configuration role to create or delete attributes.

View attributes

Go to Admin > Attributes. The page shows tabs for each attribute class: Category, Product, Company, Contact, Customer and Cluster. Select a tab to view the attributes for that class.

Column	Description
Id	Attribute ID
Name	Attribute name (UPPERCASE_WITH_UNDERSCORES format)
Description	Localized description
Group	Attribute group
Type	Data type (Text, Enum, Color, DateTime, Int or Decimal)
Unit	Unit of measure
Searchable	Whether the attribute is searchable in filters
Public	Whether the attribute is visible in the storefront
System	Whether it is a system attribute
Hidden	Whether it is hidden from the UI
Default	Default value
Date Created	When created (sortable)
Date Updated	When last modified (sortable)

Create an attribute

1. Select the tab for the attribute class you want (for example, Product).
2. Click New Attribute for the selected class.
3. Fill in the attribute details:

Field	Required	Description
Name	Yes (max 64 chars)	Attribute name in UPPERCASE_WITH_UNDERSCORES format. Cannot be changed after creation.
Description	Yes	Localized description (with language switcher)
Units	No	Unit of measure (localized)
Group	No	Grouping label
Type	No	Data type: Text, Enum, Color, DateTime, Int or Decimal. Cannot be changed after creation.
Select a valueset	Conditional	Only for Enum type. Pick the value set that provides dropdown options. Cannot be changed after creation.
Default value	No	Depends on the type: text, enum values, color picker, date/time picker, integer or decimal
Searchable	No	Include in search and filter functionality
Public	No	Visible in the storefront

tip

Mark an attribute as Searchable to let users filter products by it in the catalogue. Mark it as Public to display it on product detail pages. An attribute can be Searchable without being Public, or the other way around.

| System | No | Mark as a system attribute | | Hidden | No | Hide from the UI |

4. Click Save.

Edit an attribute

Click any row to open the edit dialog. The Name, Type and Valueset fields cannot be changed after creation.

Delete attributes

1. Select one or more attributes using the checkboxes.
2. Use the delete action.
3. Confirm the deletion.

Search and filter attributes

Use the search bar to find attributes by name. You can also apply filters:

Filter	Type	Description
Names	Multi-value chips	Filter by attribute names
Types	Checkboxes	Text, Enum, Color, DateTime, Int, Decimal
Groups	Multi-value chips	Filter by group names
Searchable	Radio	Yes or No
Public	Radio	Yes or No
System	Radio	Yes or No
Hidden	Radio	Yes or No

Related pages

• Value Sets - manage the value sets used by Enum-type attributes
• Backoffice Users - manage admin users and permissions