Selected Variant

Displays the customer's completed variant selection (e.g. "Black / L") anywhere on the page.

Last updated

Selected Variant icon

How to use

  1. Place the component anywhere on the product page and connect ⛁ Butter Data to the product's Butter Data CMS field.

  2. Set the Format template — {{variant}} inserts the customer's selection, e.g. "You selected {{variant}}".

  3. Set the ↳ Separator between option values (defaults to " / ").

  4. Choose the Incomplete behavior — Hide or Text — for before the selection is complete.

  5. Style Font, Color, and Transform.

Formatting the selection

The Format control is a copy template — anywhere you write {{variant}}, the component inserts the customer's chosen option values joined by the ↳ Separator (default " / "), e.g. "Black / L". Use it to build copy like "You picked: {{variant}}" without adding a separate text element.

Handling an incomplete selection

Until every option is chosen, Incomplete controls what shows: Hide renders an invisible placeholder that preserves layout, or Text shows the ↳ Text fallback copy you set. On a single-variant product, the Variant Selector's auto-select runs first — until it does, this component briefly shows the incomplete state.

Staying in sync with the page

This component is read-only — it never sets the selection itself. It reads the same shared selection the Variant Selector writes to, so it updates instantly when the customer picks an option anywhere on the page, including through a shared ?variant= URL parameter. It reflects the page-level selection, so it won't work per-row inside a Cart List — use that component's own cart-item data there instead.

Questions? Join our Slack community