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 is in the 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. There is 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 is needed only 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, and 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 and one column per driven part. For example, “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 for your own reference and is 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, and a rule can block variations. If a rule blocks the 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.