Layouts & which to use

Two settings control how a bundle looks. This page explains both, then recommends the right combination for each kind of store.

There are two separate choices, both at the top of the Bundle Items tab:

  1. Layout is the whole-page layout: List, Grid, or Step by step.
  2. Multiple items is how the units of a single multi-quantity item are arranged: Stacked, Compact cards, Table, or the Quantity grid.

They are independent, so you can mix them, for example a List page with a Quantity grid inside one item.

See them

Prefer to look before you choose? Layouts in pictures shows every option with a screenshot and the exact setting that produces it.

Page layout

List (default)

Every item is a card, stacked down the page, each with its photo, options and price. The customer sees the whole bundle at once. Best for most bundles, especially short ones.

Grid

The same cards arranged side by side in a responsive grid. Good when a bundle has several items and you want them to feel like a set the customer scans rather than a long scroll.

Step by step Pro

One item in focus at a time, with numbered steps, green ticks, Back and Next buttons and free jumping between steps. The running total stays visible throughout, and the customer lands on the first incomplete step (handy for edit-from-cart and shared links). Best for long or involved builds like a PC configurator, where showing everything at once would overwhelm. Without the Builder, Step by step falls back to List.

Multiple items: displaying a product bought in quantity

This setting only changes a variable product the customer can buy more than one of. Simple products and single-unit slots always look the same. It also applies inside a choice slot, so whichever product the customer picks is shown in the layout you chose.

Stacked (default)

One card per unit, down the page. Clear and familiar; existing bundles look exactly as before.

Compact cards

A tidy card per unit with the fields wrapping neatly and no sideways scrolling. The best choice when each unit is personalised (a name, a number, a position), because every unit has room for its own details.

Table

One compact row per unit, attributes as columns. A spreadsheet-style view for people who like to fill a grid quickly. With many columns the row scrolls sideways, so Compact cards is usually the friendlier default.

Quantity grid Pro

The customer taps a colour and types how many of each size, building a bulk run like five small navy plus five large red in one grid, instead of configuring ten units one at a time. Ideal for workwear, team kit and any size run. See Quantity grid.

Two helpers for multi-unit items

Which combination to use

Your store Page layout Multiple items
A small fixed pack (2 to 3 items) List Stacked
A bundle with many items to scan Grid Stacked
A long or complex configurator Step by step Pro Stacked or Compact cards
Personalised team kit (names per unit) List or Grid Compact cards
A bulk size run (workwear, 10+ split across sizes) List Quantity grid Pro
Fast spreadsheet-style entry List Table
Rule of thumb

Pick the page layout for how the bundle reads as a whole, then pick Multiple items for how a single repeated item is filled in. When in doubt, leave both on their defaults (List and Stacked); they suit most bundles.

Defaults stay List and Stacked, so nothing changes on existing bundles until you choose otherwise.


Still stuck? Email a human. The person who reads it is the person who builds the plugin.