Bundle Group

The optional extras a customer can tick on before adding to cart — a travel case, a second flavour, a companion formula. Selected add-ons go into the cart in the same click as the main product, so the customer presses Add to Cart once.

Almost everything about a bundle group — its heading, its items, its layout, whether you can pick one or several — is defined in a Bundle Group metaobject in Shopify admin. This block’s job in the customizer is only to choose which group or groups to show.

Add it inside Product Main, above the Add to Cart button.

Settings

Setting	What it does
Bundle group	Pick one or more Bundle Group metaobject entries. They render in the order you list them. Leave empty and the block shows nothing.

What lives on the metaobject

Everything else. Each Bundle Group entry carries:

Field	What it controls
Title	The heading above the group.
Description	A short line of copy under the heading.
Layout	Swatches for a compact grid of image tiles, anything else for full-width rows.
Singular	On means a customer can pick only one item; off allows several.
Clearable	Adds a None tile so the customer can back out of a selection.
Standalone	Items get their own Add to Cart instead of joining the main product’s.
Modal	An optional page opened by a “Learn More” link next to the heading.
Modal link text	The wording of that link. Defaults to “Learn More”.
Bundle items	The actual add-ons.

Each bundle item points at one or more product variants, and can override the image, title, description, price and compare-at price that the variant would otherwise supply. An item can also be marked presentational, which makes it display-only.

The three kinds of item

This is the part worth getting right, because the three behave very differently in the cart:

• Inline (the usual case) — the customer ticks it, and it’s added alongside the main product when they press Add to Cart. One click, one cart update.
• Standalone — the item carries its own add-to-cart control and is bought on its own, independently of the main product.
• Presentational — display only. It always appears selected and it is never added to the cart, because it’s already part of the main product’s SKU. Use it to show what’s included in a kit, not to sell anything.

Presentational items are not purchases

A presentational item looks selected and looks like the others, but nothing is added to the cart for it. Marking a genuine add-on as presentational means customers believe they’re buying something they never receive. Use it only for contents already inside the box.

Prices on the metaobject

Bundle item prices are optional. Left empty, an item shows the variant’s real price and compare-at price, formatted correctly for the customer’s currency.

Typed prices don’t convert currency

The metaobject’s price fields are plain text. Whatever you type is printed exactly as typed — it isn’t formatted as money and it doesn’t follow currency or market settings. Leave them empty and let the variant’s real price show, unless you specifically need copy like “Free with purchase”.

The Learn More modal

When a group has a Modal page set, a “Learn More” link appears beside the heading. Clicking it fetches that page and shows its content in an overlay, without leaving the product page.

The overlay pulls a modal cards section out of the linked page. A linked page that doesn’t contain one shows “Failed to load content” instead — so the page you point at needs the right section on it, not just any content.

Tips

• Put it above Add to Cart. Add-ons are a decision made before buying; below the button, most customers never see them.
• Keep a group to a handful of items. The row layout is full width, so six items push the Add to Cart button a long way down the page. Use the swatch layout when a group needs to be longer.
• Turn on Clearable for optional groups. Without a None tile, a customer who ticks something by accident has no obvious way to untick it.
• Use Singular for either/or choices. A flavour choice should be singular; a set of independent accessories shouldn’t be.
• Check the cart after changing a group. The block is the one place on the product page where a customizer change alters what actually gets bought. Add-to-cart once with add-ons selected and confirm the cart contents match.