Skip to main content

Glossary

What is a product variant?

A product variant is one purchasable version of a product that differs along defined dimensions, such as size, color or pack size, while sharing the same underlying product.

In plain words: A variant is what a shopper actually puts in the basket: the olive jacket in size M, not 'the jacket'. Variants of one product share everything except their values on the variant axes, such as color and size, and each one has its own identifier, stock and often its own price.

Also called: variant, child product, option

Published by Youzu · Editorial policy

Published

Diagram

A color by size grid

A color by size gridA color by size grid. Size M; Size L; Olive; Black; Variant 1; Variant 2; Variant 3; Variant 4.Size MSize LOliveBlackVariant 1Variant 2Variant 3Variant 4
Each cell of the grid is one variant of the same product. Modelled on the schema.org hasVariant property.

Why it matters

Variants let a store show one product page with options instead of many near-identical pages. When variants are stored as unrelated products, filters double count, reviews split and shoppers have to search again to find another size.

How it works

  1. Define axes

    Name the dimensions that create purchasable options in this category.

  2. Group

    Link each version to its product and record its value on each axis.

  3. Identify

    Give each variant its own identifier and keep stock per variant.

Where a variant sits between the family and the offer
LevelExampleWhat it holds
FamilyThe jacket model in all colors and sizesShared identity, content and the variant axes
VariantThe olive jacket in size MIts color and size, its own identifier and stock
OfferSeller B's used terracotta armchairPrice, condition and delivery for one seller

Examples

  • Messy titles, clean axes

    Titles like 'jkt olive s', 'olive jkt - L' and 'Jacket Olive M' carry the same 2 axes in different forms. Read as color and size, they become 3 of the 9 variants of one jacket.

  • Size makes a variant, not a duplicate

    The 2-seat navy velvet sofa is a variant in the same family as the 3-seat sofa, not a duplicate of it.

  • A width outside the options

    Seller D's 780 mm armchair is not an option of the 640 mm armchair in this example, so it stays a separate product.

Common mistakes

  • Variants as separate products. 9 listings of one jacket stay as 9 products, so search repeats it and its reviews split.

  • Axes in free text. Sizes and colors written in the description instead of fields cannot be grouped or filtered.

Product family
A group of related products or variants that share a model or brand identity, such as every size and color of one jacket model.
Marketplace offer
One seller's listing of a product with its own price, stock and condition, attached to a shared product record.

In Youzu

Youzu helps marketplaces, classifieds and retailers turn raw seller and supplier product data into structured, reviewable catalog records.

Variants and families

Sources

  1. Item group ID [item_group_id], Google Merchant Center Help. support.google.com/merchants/answer/6324507. Accessed .

  2. ProductGroup, Schema.org. schema.org/ProductGroup. Accessed .

FAQ

Questions buyers ask

Often they map one to one: each variant gets its own SKU so stock can be counted. But a SKU is an internal stock-keeping code, while a variant is a modeling concept. Some businesses keep several SKUs for one variant, for example per warehouse, so keep the 2 ideas separate in your data model.

It depends on the category and the channel. Some catalogs treat pack size as a variant axis of one product; others list multipacks as separate products with their own identifiers. Decide per category, write the rule down and apply it the same way for every seller and supplier.

Products, variants and seller offers are separate records: the same product sold by several sellers is one product with several offers. Matching is precision-first: when 2 listings cannot be shown to be the same product they stay separate, and uncertain cases can go to review.

Last reviewed

Next step

Automate Commerce. Make shopping personal.

Bring your catalog, listing flow or shopping idea. Let's find the right place to start.

Book a demo

Tell us about your catalog and we will get back to you.