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.

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 (you can override that per part with its visibility toggle), because showing them would invite contradicting choices.
  • 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.