Skip to content

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.

Step 1/6

A link group makes several parts change together — the shopper picks once, every linked part follows, and finishes always match.

Link groups — shared finishes
Step 1 of 6
  1. A link group makes several parts change together — the shopper picks once, every linked part follows, and finishes always match.
  2. Matching & rules lives in configurator settings — open the matching editor to author the group.
  3. Open the matching editor — this demo links dozens of shelf modules to a single driver.
  4. The driver’s variations become the rows of the table — its picker stays visible to the shopper.
  5. Driven parts follow the driver and are auto-hidden from the public picker — here, dozens of modules follow one selection.
  6. One row per driver variation: when the driver changes, every mapped part swaps to its matching variation — Auto-fill seeds the obvious matches.

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.

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.

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.

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.