Skip to content

Visibility groups — alternatives

A visibility group collects alternative parts where only one is visible at a time — and the public viewer shows a switch for it. Classic use: a shower column offered with two different shower-head sets; the shopper flips between them.

Group two or more parts as alternatives and name the group after the slot it fills — e.g. Shower head. Requirements the panel enforces:

  • At least two non-base parts that each have a model. The base part can’t be an alternative — it anchors the assembly.
  • A part belongs to at most one visibility group.

The public picker then renders the group as a single switch, not as separate part rows.

Groups can share an axis: alternatives that must switch together across several slots. When groups are on the same axis with matching values, flipping one flips its partners in the same move — the panel shows this as “Coupled with: …”.

Use this when a design language spans multiple slots — e.g. “Round” vs “Square” hardware where the head set, the valve trim and the handles must all flip as one.

Both can hide things — pick by intent:

  • Visibility groupstructural alternatives: the product genuinely comes in two arrangements and the shopper chooses one.
  • Rulesconditional availability: everything coexists, but some combinations are invalid.

The Setup Check lints both — including coupling values that reference nothing (dead values that would make a switch position show an empty scene).