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
- A variant switcher on the product page — buttons or color swatches, each variant is a product of its own.
- Group view — buttons, color swatches, variant photos or a list.
- Colors in catalog cards — the customer sees every color before opening the product.
- One card per model — in categories, search and manufacturer pages.
- Main product replacement — the catalog shows a variant that can be bought.
- One primary page for search engines — variants don't compete with each other.
How to turn on families in your store
- 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.
- 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.
- Open the module. “Store settings” → the “Catalog” section → the “Product families” card.
- Turn on the “Enabled” switch in the screen header, choose where to show only the main product and click “Save”.
1
Product families card2
Enabled state- Opens the product family settings.
- Shows whether the module is enabled and whether the latest changes reached the store.
1
Enabled switch2
Auto-replace main product3
Show only the main product- The Enabled switch turns product families on for the site after you save.
- When the main product runs out, its place is taken by the variant with the most stock.
- 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 website | Where 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 members | Products 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 product | Chosen 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
- In Elbuz, open the “Attributes” window → the “Color Reference” button (brush).
- In the “Group attribute” field, select the attribute. The “Group view” field appears next to it.
- Choose the view — it's saved right away and goes to the website with the next export.
1
Group view2
Color column3
Image cell- How to show the group on the product page: automatically, as buttons, swatches, variant photo or a dropdown.
- The swatch color for the value.
- The value image for the Variant photo view, chosen from the media library.
| Group view | What the customer sees |
|---|---|
| Automatic | Swatches 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 photo | Thumbnails: the value image from the “Image” column, or the variant product's photo if there's none |
| Dropdown | A 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.
1
Color: Graphite2
Current swatch3
Another variant- The group name and the value of the open variant.
- The current variant is highlighted.
- 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.
1
Family swatches2
Current swatch- Family colors: each swatch leads to its own variant.
- 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:
| Style | What the customer sees |
|---|---|
| As set up | As set in “Group view” (default) |
| Buttons | All values as buttons with a label |
| Colours | Swatches; a value without a color — a button |
| Photos | Thumbnails of variant photos |
| List | All 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.
1
In categories2
List of categories3
In search4
In manufacturers- Hides variants in the categories from the list.
- The categories where the rule applies; subcategories are set separately.
- One card per model in site search.
- One card per model on manufacturer pages.
| Switch | Where one card stays |
|---|---|
| In categories | Only in categories from the “Category list” field. Add a subcategory to the list separately |
| In search | In site search results. If Elbuz smart search is on, it returns the results, and this switch doesn't affect them |
| In manufacturers | On 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 see | Why | What 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
- If families aren't built in Elbuz yet — How to group color and size variants into a product family.
- If you need to understand how the store settings window works — Store settings.
- If changes from Elbuz don't reach the website — Exporting to your website via the tunnel.
