↑↓ selectEnter openEsc close

    1. Elbuz

    How to group product variants into a family on your website

    5 min readUpdated

    A family links separate products of one model — colors, storage, volume. Customers switch variants on the product page; the catalog can show one card per model. Families come from Elbuz with the export.

    When you need this:

    • A kettle in three colors — each color swatch opens its own kettle.
    • Four identical smartphones in search — one model card stays, the rest go to the switcher.
    • The main color is sold out — the catalog shows the best-stocked color.
    • Google sees variants as duplicates — the main product page becomes primary.

    Where to start: build families in Elbuz, then “Store settings” → “Catalog” → “Product families”.

    What product families can do

    How to turn on families in your store

    1. Build families in Elbuz. Mark the attributes the variants differ by (color, storage, volume), give the variants the same family name and set the colors. Step by step: Product families.
    2. Wait for the export. Families go to the store together with the products: in an Elbuz CMS store this is on from the moment it's created. How the export works: Exporting to your website via the tunnel.
    3. Open the module. “Store settings” → the “Catalog” section → the “Product families” card.
    4. Turn on the “Enabled” switch in the screen header, choose where to show only the main product and click “Save”.
    The Catalog section of store settings with its module cards
    1Product families card
    2Enabled state
    1. Opens the product family settings.
    2. Shows whether the module is enabled and whether the latest changes reached the store.
    The Product families module window, maximized
    1Enabled switch
    2Auto-replace main product
    3Show only the main product
    1. The Enabled switch turns product families on for the site after you save.
    2. When the main product runs out, its place is taken by the variant with the most stock.
    3. Where to show only the main product of a family.

    Without “Enabled”, the website shows neither the switcher nor colors in cards, even though the families are already exported. How the module screen works and what the marks on the right mean: Store settings.

    Where groups and the main product come from

    Everything the customer sees in the switcher, the export takes from Elbuz:

    On the websiteWhere it comes from in Elbuz
    Group above the variants: “Color”, “Internal storage”An attribute with the “Use to create variable products” flag. The group name is the attribute name
    Family membersProducts with the same “Variant family name”, export turned on and the variant attribute filled in
    Buttons, swatches, photos or a list“Group view” in the “Color Reference” (below)
    Swatch color, value image“Color Reference”; a two-color value gives a swatch split in two halves
    Main productChosen by the export: products in stock first, and of those — the most expensive

    A product without the variant attribute filled in won't get into the family on the website, even with a family name.

    Families on the website aren't edited by hand: every export rebuilds them from Elbuz data. Change members, the main product and colors in Elbuz — the website updates with the next export.

    How to choose the group view: buttons, swatches, photos or a list

    1. In Elbuz, open the “Attributes” window → the “Color Reference” button (brush).
    2. In the “Group attribute” field, select the attribute. The “Group view” field appears next to it.
    3. Choose the view — it's saved right away and goes to the website with the next export.
    Color Reference window with Group view and the first rows of the table
    1Group view
    2Color column
    3Image cell
    1. How to show the group on the product page: automatically, as buttons, swatches, variant photo or a dropdown.
    2. The swatch color for the value.
    3. The value image for the Variant photo view, chosen from the media library.
    Group viewWhat the customer sees
    AutomaticSwatches if the reference has colors or the attribute type is “Color”; otherwise buttons (default)
    Text (buttons)Buttons with a label: “128 GB”, “XL”
    Colour (swatches)Color swatches; a value without a color shows as a button
    Variant photoThumbnails: the value image from the “Image” column, or the variant product's photo if there's none
    DropdownA dropdown list — when there are many values, like shoe sizes

    The value image is chosen in the reference's “Image” column: a click opens the media library. For paint, for example, a photo of the can in each shade. Images are needed only for “Variant photo”; other views don't show them.

    What the customer sees

    The product page shows the group name and the current value, for example “Color: Graphite”, with all the family's variants below. A click opens that variant's page with its own photos, price and stock. The current variant is highlighted.

    A variant with no stock is faded and can't be clicked; a button is also struck through. The same happens when there's no product with this value and the same other attributes. With “128 GB, blue” and “256 GB, green”, “256 GB” is struck through on blue.

    A disabled product doesn't show in the switcher at all.

    Product page of a family variant with color swatches
    1Color: Graphite
    2Current swatch
    3Another variant
    1. The group name and the value of the open variant.
    2. The current variant is highlighted.
    3. Another variant of the family: clicking it opens its own page with its own photos, price and stock.

    Colors in catalog cards

    In categories, search and product collections, a family product shows its color swatches — up to 6, the rest as “+N”. Each swatch leads to its own variant.

    A group with the “Variant photo” view shows small thumbnails instead of swatches. Buttons and lists don't show in the card.

    Category listing: product cards with color swatches
    1Family swatches
    2Current swatch
    1. Family colors: each swatch leads to its own variant.
    2. The color of the product on this card.

    Swatches show when the store design has “Show” for “Colour swatches” in the “Product card” group. Some ready-made designs have “Hide” there.

    If the product page has no switcher

    The switcher is shown by the “Product variants (family)” design block. Most designs already have it. If yours doesn't, add it in the design editor: the “Product page” page → the “Photos and purchase” section → “Blocks”.

    Where: “Store settings” → “Store” → the “Store theme” card → the “Design editor” icon.

    The block's “Style” field changes the switcher on every product page:

    StyleWhat the customer sees
    As set upAs set in “Group view” (default)
    ButtonsAll values as buttons with a label
    ColoursSwatches; a value without a color — a button
    PhotosThumbnails of variant photos
    ListAll groups as a dropdown list

    How to keep one card per model in the catalog

    The “Show only the main product” section hides family variants from lists. The main product stays, and the others are reachable from its switcher. Products outside families show as before.

    If the main product doesn't make it into the list — it isn't in this category or search doesn't find it — the model doesn't show there at all.

    The 'Show only the main product' block with category, search and manufacturer options
    1In categories
    2List of categories
    3In search
    4In manufacturers
    1. Hides variants in the categories from the list.
    2. The categories where the rule applies; subcategories are set separately.
    3. One card per model in site search.
    4. One card per model on manufacturer pages.
    SwitchWhere one card stays
    In categoriesOnly in categories from the “Category list” field. Add a subcategory to the list separately
    In searchIn site search results. If Elbuz smart search is on, it returns the results, and this switch doesn't affect them
    In manufacturersOn manufacturer pages

    With “In categories” on and “Category list” empty, the screen won't save: the field shows “Required — the module will not work without it”. Categories are picked from the Elbuz catalog. A category not yet on the website is rejected: “Not in the store catalog: upload it to the store or choose another one”.

    All switches are off by default: lists show every variant, and the family works only on the product page and in cards.

    What happens when the main product is sold out

    Turn on “Auto-replace main product” in the “Availability” section. Once an hour the store checks families: if the main product has zero stock, the variant with the most stock becomes the main one.

    Only a variant enabled on the website with its attributes filled in qualifies. If none is in stock, the main product doesn't change.

    Without auto-replace, the main product is updated with the next export — by its rule. So after an export, the main product may be a different variant from the one auto-replace picked.

    How search engines see a family

    “Canonical page — main product of the group” in the “Search engines” section makes the main product page primary for Google. Variant pages point to it, so they aren't treated as duplicates. When it's off, each variant is its own primary page.

    When the main product changes (auto-replace or an export), the new main product's page becomes the primary one.

    The Elbuz theme adds a family description for Google to the product page by itself as soon as the module is on. It lists all variants with prices and availability — nothing else to turn on.

    Scenarios

    A smartphone with different storage: one card in search

    In Elbuz, the “Internal storage” attribute is a variant attribute, and all variants share one family name. In the module, turn on “In search”, “In manufacturers” and “Canonical page — main product of the group”. Search and the brand page show one model card; the product page has “128 GB”, “256 GB”, “512 GB” buttons.

    A kettle in three colors: colors right in the catalog

    In Elbuz, “Color” is a variant attribute, and every value in the “Color Reference” has a color. The design has “Show” for “Colour swatches”. After the export and turning on the module, the kettle's catalog card shows three swatches, and the product page has the same color choice.

    A refrigerator: the category shows the color in stock

    Turn on “In categories”, add “Refrigerators” to the “Category list”, turn on “Auto-replace main product”. The category shows one model card; when white sells out, within an hour it's replaced by the color with the most stock.

    What to do when a family doesn't work on the website

    What you seeWhyWhat to do
    The product page has no switcher The module is off, the design has no “Product variants (family)” block, or the product isn't in a family Turn on the module and save, add the block, check the family name, the variant attribute and the product export in Elbuz
    Labeled buttons instead of color swatches “Group view” is “Text”, or “Automatic” with no colors in the reference; or the design block's “Style” is “Buttons” Choose “Colour (swatches)” or set colors and wait for the export; in the block, set “As set up”
    “Variant photo” shows the product photo instead of your image The value has no image in the reference, or the changes aren't exported yet Choose an image in the “Image” column and wait for the export
    One labeled button among the swatches This value has no color in the reference, for example “matte black” next to “black” Set a color for the value or merge the spellings into one
    The product page has colors, but catalog cards don't The design has “Hide” for “Colour swatches” Design editor → “Product card” → “Colour swatches” → “Show”
    A variant is struck through, though the product exists Zero stock on the website, or no product with this combination (see above) Check the stock or add a product with the needed combination
    A variant disappeared from the switcher The product is disabled on the website or removed from the export in Elbuz In Elbuz, check the product export and the export settings for out-of-stock products
    The category still shows all variants “In categories” is off, or this category isn't in the “Category list” Add the category (a subcategory separately) and save
    You changed the family in Elbuz, but the website shows the old one The changes aren't exported yet Wait for the export or run it in Elbuz

    FAQ

    What happens if I turn off the module?

    The switcher, the swatches in cards and variant hiding disappear — all products show as separate cards again. Families stay on the website: turn the module back on and everything returns.

    Does the customer see the family name?

    No. The family name only links products in Elbuz. The customer sees the group name (“Color”) and the variant value (“Graphite”).

    Can I pin the main product by hand?

    No. The export chooses it, and between exports — auto-replace, if it's on. More: Where groups and the main product come from.

    Can customers open a variant that's out of stock?

    Yes, Elbuz support can turn this on. Then such a variant stays faded, but isn't struck through and opens.

    Variants are in different categories — does the family work?

    Yes, the switcher shows all variants. But with “In categories”, a category from the list shows only the main product: if it isn't there, the model doesn't show in that category.

    Where to find it and who has access

    Menu
    Directories → Operations → Store settings → “Catalog” → “Product families”
    Other entry points
    family members — the “Products” and “Attributes” windows in Elbuz
    Access rights
    the “Store settings” window in group permissions
    Prepare
    variant attributes, the family name and colors in Elbuz, export to the store

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free