Link groups — shared finishes
A link group makes several parts change together: the shopper picks Walnut once and every linked part follows, so finishes always match. Classic use: a sofa whose body, armrests and cushions share one fabric choice.

A link group makes several parts change together — the shopper picks once, every linked part follows, and finishes always match.
That’s the whole flow — now try it live.
- A link group makes several parts change together — the shopper picks once, every linked part follows, and finishes always match.
- Matching & rules lives in configurator settings — open the matching editor to author the group.
- Open the matching editor — this demo links dozens of shelf modules to a single driver.
- The driver’s variations become the rows of the table — its picker stays visible to the shopper.
- Driven parts follow the driver and are auto-hidden from the public picker — here, dozens of modules follow one selection.
- One row per driver variation: when the driver changes, every mapped part swaps to its matching variation — Auto-fill seeds the obvious matches.
When you don’t need one
Section titled “When you don’t need one”A link group only earns its place when two or more parts must change together. A product with a single pickable part — one part with variations, everything else fixed — has nothing to couple: its picker already behaves correctly with no group configured. See the baseline behaviour.
How it works
Section titled “How it works”A link group has:
- A driver part — its variations become the rows of the mapping table, and its picker stays visible to the shopper.
- Driven parts — they follow the driver. Driven parts are auto-hidden from the public picker because showing them would invite contradicting choices. To let a driven part be picked directly as well, open it and turn on Show in picker — the link still applies whenever the driver changes.
- The mapping table — one row per driver variation, one column per driven part: “when the driver is Walnut, this part shows Walnut-matching variation X.”
Name the group after what it means to the shopper — e.g. Finish — the label is your own vocabulary, not the shopper’s picker text.
Constraints the panel enforces
Section titled “Constraints the panel enforces”These rules exist so behaviour is always predictable:
- A part can’t be both a driver and driven. If a part already drives a group, it can’t be added as driven elsewhere — put all coordinated parts in one group instead.
- A variation is never controlled by two groups. Variations already used in another group are hidden from the dropdowns here.
- An empty mapping cell means “this driver value doesn’t change that part” — the Setup Check flags cells you probably forgot to fill.
Links and rules together
Section titled “Links and rules together”A link sets driven parts to specific variations — a rule can block variations. If a rule blocks the very variation a link would set, the rule wins and immediately undoes the link. The Setup Check detects this contradiction and names both the group and the rule, so you never ship a config that fights itself.
