Attributes
Attributes are product properties that define its variants. They let you create different versions of one product without creating separate products. This guide helps you understand attributes and how to manage them.
Path: Catalog › Products › Attributes
What attributes are
Attributes are properties that can have different values. Examples:
- Color — values: red, blue, green, black
- Size — values: XS, S, M, L, XL, XXL
- Weight — values: 250g, 500g, 1kg
- Material — values: cotton, polyester, blend
- Connector type — values: USB-C, USB-A, Lightning
Each attribute has a type that decides how it is displayed in the store.
Attribute table
In Catalog › Products › Attributes you see a table of all attributes. Above it is a search field.
Columns
- Name — attribute name (e.g. "Color")
- Type — display type (Dropdown Select, Color Swatch, Button, Variant Image)
- Values — the list of attribute values (expand a longer list)
- Usage — how many products and variants use the attribute; click the count to see the products with this attribute. An unused attribute is marked "unused"
- ⋯ — row menu with Edit and Delete
Creating a new attribute
Path: Catalog › Products › Attributes › Create Attribute button
The Create Attribute button in the page header opens the Create New Attribute dialog. Fill in the fields below and confirm with Create Attribute.
Attribute name
Enter the attribute name, for example:
- Color
- Size
- Weight
- Material
This field is shown as a heading in the store (in a multilingual setup, enter the name in each language).
Attribute type
Choose how the attribute is displayed in the store:
Dropdown Select
A classic dropdown menu. The customer picks a value from the list. This is the most commonly used type. Examples:
- Size (XS, S, M, L, XL)
- Weight (250g, 500g, 1kg)
- Material (cotton, polyester)
Color Swatch
A special type for colours. A small square in the given colour is shown. Example: the attribute "Color" with the values "Red", "Blue", "Green" is displayed as three coloured squares.
Color attribute
With the Color Swatch type you do not type the values as text — you pick them by ticking colours in a predefined palette.
Button
Displayed as a button with text. Suitable for:
- Gender (Male, Female, Unisex)
- Type (Classic, Modern, Retro)
- Shape (Round, Square, Rectangular)
Variant Image
Displayed as an image. The best choice when you want the customer to see a visual preview. Examples:
- Images of different colours
- Images of different patterns
- Images of different designs
Attribute values
Enter the attribute values separated by commas (with the Color Swatch type you pick colours from the palette). Examples:
For the "Size" attribute:
XS, S, M, L, XL, XXLFor the "Color" attribute:
Red, Blue, Green, Black, WhiteFor the "Weight" attribute:
250g, 500g, 1kg, 2kgFor the "Material" attribute:
100% Cotton, 100% Polyester, 80% Cotton + 20% PolyesterEnter values without leading or trailing spaces.
Editing an attribute
Path: Catalog › Products › Attributes › in the attribute's row, ⋯ menu › Edit
The Edit Attribute dialog opens, where you can change:
- The attribute name
- The display type
- The values
When done, click Save (close the dialog with the cross to leave without saving).
Deleting an attribute
Path: Catalog › Products › Attributes › in the attribute's row, ⋯ menu › Delete
After clicking Delete and confirming in the dialog, the attribute is deleted. If variants use the attribute, the dialog tells you how many are affected.
WARNING
This operation cannot be undone. If the attribute is used in product variants, it is automatically removed from those variants when deleted.
How to use attributes when creating products
Step 1: Create attributes
First create all the attributes you need in Catalog › Products › Attributes.
Step 2: Assign attributes to a product
When creating a product, choose the attributes you want to use for variants in the Attributes tab.
Step 3: Create variants
Open the Variants tab in the product and create the variants — fastest with the Generate variants button, which creates every combination of the chosen attribute values at once.
More information in Variants.
Examples of typical attributes
Clothing
- Color — type: Color Swatch (Red, Blue, Green, ...)
- Size — type: Dropdown Select (XS, S, M, L, XL, XXL)
- Material — type: Dropdown Select (Cotton, Polyester, Blend)
Footwear
- Color — type: Color Swatch
- Size — type: Dropdown Select (35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46)
- Width — type: Dropdown Select (Narrow, Normal, Wide)
Food
- Weight — type: Dropdown Select (250g, 500g, 1kg)
- Flavour — type: Button (Sweet, Sourdough, Bitter)
Electronics
- Color — type: Color Swatch (Black, Silver, Gold)
- Capacity — type: Dropdown Select (64GB, 128GB, 256GB, 512GB)
- Connectors — type: Dropdown Select (USB-C, USB-A, Lightning)
Tips and tricks
Consistency
Name attribute values consistently. For example:
- Good: Red, Blue, Green
- Bad: red, BLUE, green
Value order
Arrange values logically. For sizes use the order XS → S → M → L → XL, not a random one.
Short values
If you have long names, try to shorten them. For example:
- Instead of: 100% Cotton + 0% Polyester
- Use: 100% Cotton
Visual types
- Use Color Swatch for colours — the customer sees right away what it looks like
- Use Variant Image for variants with a visual difference
- Use Button for binary choices (Male/Female, Yes/No)
Best practice
Set attributes for all products, even those without variants. It improves the overall quality of search results and recommendations across your store.
More information
- How to create a product with variants: Creating Products
- How to manage variants: Variants