How groups work

The building blocks of a combined listing: groups, options, values, and linked products.

A product group is the unit everything else builds on: it links a set of your existing Shopify products and describes which option value each product represents. Your products themselves are never modified.

Anatomy of a group

A group: one option (Color), three values, each linked to one of your products.

Term	Meaning	Example
Group	A named set of linked products. The name is internal — customers never see it.	Hoka Tecton X 3 — Women's
Option	A dimension shoppers choose by. Rendered as a widget (swatch, buttons, dropdown…).	Color
Value	One choice within an option. Each value has a swatch (image or color).	Red
Linked product	The Shopify product a value (or combination of values) points to. Selecting it navigates the shopper there.	Tecton X 3 — Red

Key rules

• One group per product. A Shopify product can belong to only one group in your store. The product picker disables products that are already taken.

• Products are untouched. Grouping adds display data alongside your products; titles, prices, variants, and inventory stay exactly as they are.

• Values are unique per option. Two values in the same option can't share a name.

Group statuses

Status	On the storefront?	Typical use
Active	✅ Rendered	The normal, live state.
Draft	❌ Hidden	Work in progress.
Archived	❌ Hidden	Retired groups you want to keep.

Complete vs. incomplete

A group is incomplete when at least one option-value combination has no linked product. Incomplete groups still render the values that are linked, but the Groups index flags them so you can finish the mapping.

Incomplete groups are flagged right on the index — filter to the Incomplete tab to find them fast.

In this section

• Group types — which grouping model fits your catalog.

• Create and edit a group — pick your type for the full guide: single option, multiple options, single choice.

• Group by title pattern — bulk auto-detection from product titles.

• Manage groups — search, filter, bulk actions.

• Import and export with CSV.

• Translations — option and value names per language.