How to set up bundle includes

The Bundle Includes block lists the products a bundle is made of, on the bundle product's own page. Each row shows the product image, its title, the exact variant you chose, and optionally its price — so shoppers know precisely what's in the box before they add it to the cart.

Customers buy the bundle with the product page's own Add to cart button, at the bundle product's own price — Helix does not add the listed products to the cart separately.

The contents are read from a metafield on the bundle product, so every bundle lists its own set of products.

Step 1 — Create the metafield

In Shopify admin, go to Settings → Metafields and metaobjects → Products and click Add definition, then set:

Name — Bundle products
Namespace and key — modutheme.bundle_products
Type — Product variant, list of values

Click Save.

The namespace and key must be exactly modutheme.bundle_products, and the type must be Product variant — not Product. Helix reads this fixed key, and it needs a variant so it can show the right color and size on each row.

You only create this definition once — every product in your store can then use it.

Step 2 — Create the bundle product and add its contents

Go to Products → Add product and create the product customers will actually buy — for example Women's Running Trio. Give it its own title, images, price, and inventory, exactly like any other product. The products it contains stay in your catalog as separate products — you only reference them here.

Then, on that same product:

Scroll to Metafields → Bundle products.
Select the products in the bundle and, for each one, choose the exact variant it ships with.
Save the product.

Rows appear on the storefront in the order you add them here, so put the hero item first.

The variant you pick is the one shoppers see — a row for Aura core - Women with the Coral fade / 5 variant shows Color: Coral fade | Size: 5. Products with a single variant show no option line.

Step 3 — Add the block to the product page

In the theme editor, open a product template → Product information section → Details block. Hover the spot in the block list where you want the list to appear — for example just above Buy buttons — click the + that shows up, and choose Bundle Includes. (Add block at the top of Details works too, but puts the block first, above the product title; drag it down afterwards.)

Then set the copy and look of the list:

Text — the heading above the rows, for example This bundle includes:
Show price — turn on to show each product's price on its row
Show dividers — draw a line between rows
Border thickness under Product card — raise it above 0 to turn every row into its own boxed card

For the full settings list, see Product Details → Bundle Includes.

Use a separate product template for your bundles — for example product.bundle — so the block only appears on bundle products. Assign it under Online Store → Themes → Customize, or from the product's Theme template field in admin.

Result

On the storefront, the bundle product page shows the list of everything included, each row linking to the product it names. Customers still check out with the single bundle product.

A product with an empty Bundle products metafield shows nothing — the block stays hidden on the storefront. In the theme editor you'll still see three placeholder rows, so you can style the block before assigning any products.

Pricing and stock come from the bundle product itself. If you also need the components' inventory to go down when a bundle sells, set that up with a bundling app — this block controls what shoppers see, not what the cart contains.

Need help?

Whether you have a question, run into an issue, or just need some guidance, our support team is here to help.

Chat with us Submit a ticket

PreviousHow to set up a product bundle

NextHow to set up the product finder

Last updated 5 days ago