Docs Block Reference Bundle

Bundle

A single fixed product bundle — pick one bundle from the store and the block renders its products together with a single "Add Bundle to Cart" button.

When to use it

  • Featured bundle / kit on a product page
  • "Buy together" combo above the fold
  • Fixed-content offer (3 items + 1 combined price)

When not to use it

  • Variable product grids — use Products
  • Pricing tiers (Free / Pro) — use Tiers
  • Editorial card grid — use Rows

Settings

Bundle picker — button

Click "Select a bundle…" to open the picker; pick a bundle from the store. Once picked, the button shows the bundle name and a × button next to it clears the selection.

Button — text input (default: "Add Bundle to Cart")

Label of the bundle's add-to-cart button.

Toggles (single row)

  • Images (left, default: on) — show the product images
  • Prices (right, default: on) — show per-item prices

Colours (2-up row)

  • Accent — bundle accent / highlight (default: dark)
  • Fields — input / chip background (default: light grey)

Sliders

  • Max Width — 340–600px (default: 400). Bundle outer width.
  • Radius — 0–10px (default: 4). Bundle corner roundness.

Per-device overrides

Sliders and toggles have per-device values.

Common overrides:

  • Max Width — 100% on mobile so the bundle fills the column
  • Images — sometimes off on mobile to save space

Common patterns

Above-the-fold combo

Pick the featured bundle · Button "Save 15% — Add to Cart" · Images on · Prices on · Accent dark · Max Width 480 · Radius 8.

Compact upsell

Images off · Prices on · Max Width 360 · Radius 4. Place inside a cart drawer or sidebar.

Bundle hero

Pick the hero bundle · Max Width 600 · Radius 0 · Accent matches brand. Wrap in a Section with a heading + description above.


Related

  • blocks/products — for variable product grids / carousels
  • blocks/plans — for pricing-tier cards (subscription tiers)