Adding a product with variants

For

Manager

Where

Back office

Permission

Manage the catalogue

Checked on

November 14, 2026

An article sold in several sizes, colours or formats is created as a family with variants: one name, attributes (Size, Colour) and one line per variant, each with its own item code and its own barcode. Everything is created at once, or nothing is.

Before you start

• Your role must have the Manage the catalogue permission.
• Tax classes must exist (guide Setting up taxes).
• For an article with no size or colour, create a simple product: guide Adding a product.

Important

A family's attributes (here Taille and Couleur) cannot be changed once the family is created. Decide them before you save. A family has 1 to 3 attributes and 1 to 100 variants.

Create the family

1. Open Catalog > Products, then click New family with variants.

   

2. In Family name, type the name shared by all variants, for example T-shirt de sport. Each variant takes this name; it can be changed later on its sheet.

3. In Category, choose the category, for example Sports.

   

4. Under Shared by all variants, in Tax class, choose the tax class. If needed, tick Prices include taxes or With serial number: these settings apply to every variant.

   

5. Under Prices, in Selling price, type the price shared by all stores, for example 24.99. Left empty, the product cannot be sold anywhere until a price is given.

   

Choose the attributes and add the variants

1. Under Attributes, in Attribute 1, type Taille.

2. Click Add an attribute, then type Couleur in Attribute 2.

   

3. Under Variants, fill in the first line: the value of each attribute (M and Bleu), the Item code (AIDE-CAT02-M-BLEU) and, optionally, the Barcode with its Code type.

4. Click Add a variant for each further variant, and fill in its line. The Purchase cost of each variant is optional.

   

Each item code is unique among active products, and two variants never have the same values.

Create the family

1. Click Create the family, in the bar at the bottom of the window.

   

The screen shows "Family T-shirt de sport created with 3 variants." and the product list now shows only the articles of the new family. Click Show all families to go back to the whole list.

Each variant is a product in its own right, with its own sheet, stock and price. The tax class, the settings and the prices can then be changed variant by variant, on each sheet. To add a variant later, open a variant's sheet, then click Add variants in the Variants section.

Troubleshooting

"Correct the flagged attributes."

An attribute is empty, too long (60 characters at most) or written twice. Correct it before creating the family.

"Another variant already has these values"

Two lines have the same attribute values (for example M and Bleu twice). Change one of them.

"This item code is already taken by another variant"

Two lines have the same item code. Each variant has its own.

See also

• Adding a product
• Setting up taxes