Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Variant families

Link the pages of one model's variants (128, 256, 512 GB…) so visitors can switch between them, each with its own lowest price.

A phone in 128, 256 and 512 GB is best compared on three pages: a 256 GB offer must never set the price of the 128 GB model. A variant family links those pages, so a visitor on one of them sees the others with their prices and can switch.

A WooCommerce product page with the variant switcher: Memory 128, 256, 512 GB and Color Blau, Schwarz between the price and the Buy button
The switcher in the Chips style, between the price and the Buy button

What a family is

  • A name ("iPhone 15") and, optionally, a brand.

  • Dimensions — the ways the pages differ, such as Memory and Color, in display order.

  • Pages — one per variant, each with its own offers. A page belongs to one family; two pages of a family cannot have the same variant.

You don't need a page for every combination. A combination without a page is shown crossed out and can't be clicked.

Create a family

Families are created by an AI agent (Content Egg Pro), not in the WordPress admin. Ask in plain words:

Link my iPhone 15 128 GB, 256 GB and 512 GB pages as one variant family by memory.

The agent checks each page, creates the family and adds the pages. Every page needs a product passport; if a page has none, the agent creates it first. To change a family, the agent needs permission to edit all its pages.

Where the switcher appears

  • WooCommerce products: automatically, between the price and the Buy button. Choose the style or turn it off in Content Egg > Settings > WooCommerce > Variant Switcher.

  • Posts: add it yourself, directly above the offer list — the Variant Switcher block (in the Content Egg group of the block inserter), or the shortcode [content-egg-variants] ([content-egg-variants style="list"] for the list style).

The switcher shows nothing on a page outside a family, or when the family has fewer than two published pages. Drafts and private pages are never shown to visitors. When you preview a page of the family, the switcher also shows its unpublished pages, so you can check the whole family before publishing it.

Two styles

  • Chips — one row of buttons per dimension, each with the lowest price of that page. Best when pages differ in two ways (memory and color).

  • List — one row per page with its price and number of shops. Best for a few pages, or when not every combination exists: every page stays one click away.

The variant switcher in the List style: one row per variant with its price and number of shops
The List style

The prices are each page's lowest price, in your store currency on WooCommerce products. "Out of stock" means that page has no offer in stock right now; it still links.

With the Chips style, a visitor changes one dimension at a time. In a sparse family — say 128 GB Black, 256 GB Blue and 512 GB Pink — no single change leads from one page to another. Use the List style there.

One product per family in your shop

By default every variant is a product in your shop and category pages. To list each family once, set Content Egg > Settings > WooCommerce > Variant Families in Shop to One product per family. The family is then shown through its main page; search results still show every variant.

If a family's main page is not in a category, or does not match a visitor's filter (color, price…), the family is missing from that list. If your variants differ in a filtered attribute or in price, keep Show every variant.

For Google

The pages of a family are marked up as one product group (ProductGroup), so Google knows they are variants of one product. Only color, size, material, pattern, age group and gender are named as the ways they differ; Google has no property for memory. Pages outside a family are not changed.

Last updated