Skip to content

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:

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, XXL

For the "Color" attribute:

Red, Blue, Green, Black, White

For the "Weight" attribute:

250g, 500g, 1kg, 2kg

For the "Material" attribute:

100% Cotton, 100% Polyester, 80% Cotton + 20% Polyester

Enter 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 ​