For the complete documentation index, see llms.txt. This page is also available as Markdown.

Show variants as individual products

List each variant of a product as its own card in the product grid, instead of grouping all variants under a single product card.

What this does

Normally, a product with multiple variants (e.g. a T-shirt in Red, Blue, and Green) shows as one card in the grid, with shoppers picking a variant after clicking in. With this on, each qualifying variant becomes its own card — so that same T-shirt shows up as three separate cards ("T-shirt - Red", "T-shirt - Blue", "T-shirt - Green"), each linking to the product page with that exact variant already selected. A shopper filtering Color: Red sees the red variant as its own card.

This is useful when variants are visually distinct enough (e.g. different colors) that shoppers expect to browse and filter them as individual products, rather than digging through a variant picker on one card.

Turning this on makes Display chosen variant image after filtering unavailable, since each split card already shows its own correct image and price by default.

Steps

  1. In the app, go to Settings > General.

  2. In the Variants as separate products card, turn on Show variants as individual products.

  3. Configure the settings that appear below it (see next section). Split by these options is required.

  4. Click Save in the bar at the top of the page.

Settings > General — Variants as separate products card

Settings that appear once this is on

Turning on Show variants as individual products reveals several more settings, indented under the switch, that control exactly how the split works:

  • Split by these options (required) — pick which product option(s) trigger the split (for example, Color). You get one card per value of these options; other options (like Size) stay as a variant selector on that card.

  • Keep images and options after splitting — when on, each split card still shows the full original image gallery and full variant/option picker, instead of narrowing them down to just the split value.

  • Variant name in the title — Show appends the option value to the card title (e.g. "Mini Dress - Blue"); Hide shows only the base product name (e.g. "Mini Dress").

  • Only in these collections — limit where splitting applies: pick specific collections, or All Collection Pages, All Products Page & Search Page, or All. Leave it empty to split everywhere.

Settings > General — Variants as separate products, expanded

Last updated

Was this helpful?