About product options/variants

About product options/variants

Shopify Products, Variants & Options

Products

A product in Shopify is a single item you sell (e.g. "Merino Wool Sweater"). A product holds shared information — title, description, images, product type/category, and metafields — plus one or more variants.

Variants

A variant is a specific, buyable version of a product. Each variant is what actually carries a price, SKU, barcode, and inventory quantity.
  • If a product has no meaningful choices (e.g. a single book), it has exactly one default variant.
  • If a product comes in different colours and/or sizes, each concrete combination is its own variant.
Example — a sweater in {Black, Blue} × {S, M, L} produces 6 variants:
Variant
Colour
Size
SKU
Price
Stock
1
Black
S
SWTR-BLK-S
79.00
4
2
Black
M
SWTR-BLK-M
79.00
0
3
Black
L
SWTR-BLK-L
79.00
7
4
Blue
S
SWTR-BLU-S
79.00
2
5
Blue
M
SWTR-BLU-M
79.00
9
6
Blue
L
SWTR-BLU-L
79.00
3
Limits: Historically Shopify allowed up to 100 variants and 3 options per product; newer stores support up to ~2,000 variants. Every variant is a full combination of the options below.

Options

Options are the dimensions of choice that generate variants. Each option has:
  • a name (e.g. Color, Size), and
  • a set of values (e.g. Black, Blue / S, M, L).
The variants are the Cartesian product of all option values. In the example above there are two options (Color, Size) whose values multiply out to the 6 variants.
Options are how a storefront renders the swatches/dropdowns a shopper clicks; picking one value per option selects exactly one variant.

How the integration maps to Options

In the Shopify integration settings, the Option names section controls how our data lines up with your store's options:
  • Colour option label / Size option label — the exact option names used on your Shopify products. We map our colour and size data onto options with these labels, so they must match what your store uses (defaults: Color and Size).
Each label can be provided in two modes:
    Text value — a plain option name (e.g. literally "Size"). The option's values are written as free text.
    Connected metafield — instead of plain text, the option is linked to a Shopify metafield/metaobject definition (e.g. Size). This uses Shopify's structured, standardized values rather than loose text.

Metafields & the Shopify "Size" special case

A metafield is structured extra data attached to a product. Shopify ships some standard/category metafields — including a built-in Size — that provide validated, category-aware values.
When the Size option is connected to Shopify's own Size metafield, there's an important nuance surfaced:
  • Not every category supports Shopify's Size. For those, we fall back to the size field that fits the category — e.g. Cup Size for bras, Accessory Size for belts.
  • Some categories have no size field at all (e.g. bracelets, beach bags). For those we add the size as a plain text option value instead.

Related setting: Single colour option per product

When enabled, each product carries only a single colour, and separate colours are modelled as sibling products linked together via a list-of-product-references metafield. This is an alternative to putting every colour as a value under one product's Colour option.


Quick glossary

Term
What it is
Product
The overall item; holds shared info + variants
Option
A dimension of choice (name + values), e.g. Color/Size
Variant
One concrete combination of option values; carries price/SKU/stock
Metafield
Structured extra data on a product.
Sibling
A separate single-colour product linked to its colour counterparts