Variants and groups
Products are sold as variants: one row per concrete combination of options, typically a size. The Variants tab of the product editor has a generation panel on top, the table of existing variants below, and the product's Group at the bottom.
The axes you generate variants from, such as size, come from the product's attribute set, where they're marked as variant axes. See Attribute sets.
Generate variants
Steps
- Open a saved product and click the Variants tab.
- Under Variant axes, tick the values that apply to this product on each axis, for example the sizes it actually comes in.
- Optional: click Set as primary on the axis that matters most. It shows Primary axis.
- Click Generate variants.
Nucleo creates one variant per combination of the ticked values and keeps every variant that already exists, so you can generate again after adding a size without creating duplicates. Generation happens immediately, without waiting for Save.
Edit SKUs, barcodes and stock
The variants table has one row per variant, with its SKU, its Barcodes and its Available stock. The footer gives the number of variants and the total available.
Steps
- In the Variants tab, find the variant in the table.
- Edit its SKU or its Available stock in place. Stock is a whole number.
- To change its barcodes, click the Barcodes cell of the variant, or Edit barcodes above the table to edit every variant at once. See Edit barcodes.
- Click Save in the Unsaved changes bar to save every edited row at once.
Stock entered here is written to your default location. To see stock by location, open Inventory; to change the default location, see Locations.
Edit barcodes
As in Shopify, a variant can have several codes, each with its type. The first one is the primary: it's the one shown in the table, with +1 or more when there are others.
Steps
- In the Variants tab, click the Barcodes cell of a variant, or Edit barcodes above the table.
- In Edit barcodes, type each Barcode and pick its Type: Custom, EAN, UPC, GTIN, ISBN, ASIN, or one of your company's own code types.
- Click Add barcode for another code, or the remove icon to delete one.
- Click Done. The changes stay in the product until you save.
- Click Save in the Unsaved changes bar.
| Type | Format checked |
|---|---|
| EAN | 8 or 13 digits, with a valid check digit. |
| UPC | 12 digits. |
| GTIN | 8, 12, 13 or 14 digits. |
| ISBN | A valid ISBN. |
| ASIN | 10 letters or digits. |
| Custom and your own types | Any code. |
A code of a type marked One product per code, such as an EAN, can't be used by two products. Your own code types are managed in Code types.
Delete a variant
Steps
- In the Variants tab, click the delete icon of the variant.
- Confirm with Delete.
Understand how variant SKUs are built
New variant SKUs start from the product's SKU followed by the value of each axis, joined and cased according to the Variant SKU pattern of your workspace. For example, with a hyphen separator and uppercase, product JKT01 in size m gets JKT01-M.
Owners and admins set the pattern in Catalog > Settings > Catalog data > Attribute sets. See Set the variant SKU pattern.
Define the product's group
The Group panel answers a different question from variants: which other products are the same item in another color or drop. A group is defined by a Match rule, and the list of matching products updates live as you edit it. When the product has a model code, the rule starts as Model code is that code, so every color of the same model belongs to the group. Without a model code, the rule starts empty.
Steps
- In the Variants tab, scroll to Group.
- Under Match rule, pick a Field, an Operator and a value for each condition.
- If you have several conditions, choose whether all of them must match (AND) or any of them (OR).
- Check Products in this group. If it says No product matches — loosen the conditions above., relax a condition.
- Click Save in the Unsaved changes bar.
| Field | Operators |
|---|---|
| Name, SKU, Category, Gender, Colorway, Status, Model code | contains, is, starts with |
| Base price | is greater than, is less than, is |
Considerations for variants and groups
- Variants describe the product's structure, so they're always edited on Global. On a channel view the Variants tab is read-only.
- Variant prices live in price lists: expand a product in a price list to price its sizes one by one. See Price lists.
- Variants usually arrive with a product import, one row per variant. See Importing data.