> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/how-to-guides/how-to-set-up-the-bundle-builder.md).

# How to set up the bundle builder

The **Bundle builder** lets customers pick several products and see a discount update live as they add items.

{% embed url="<https://www.youtube.com/watch?v=owTVm_aQoHE>" %}
Video walkthrough: build your own bundle with Helix.
{% endembed %}

{% hint style="warning" %}
Helix only **displays** the bundle price and savings. The real discount is applied by a native **Shopify automatic discount** that you create separately. The block settings must mirror that discount exactly, or the preview will not match the checkout total.
{% endhint %}

The Bundle builder pairs with two kinds of Shopify automatic discount — **Amount off products** and **Amount off order**. Both follow the same steps, so this guide walks through one worked example: **10% off when a customer buys 3 or more products from the Men's hiking collection.** For an order-level discount, pick **Amount off order** and a **Purchase amount** minimum instead of a quantity — everything else is identical.

***

## Step 1 — Create the Shopify discount

In Shopify admin, go to [**Discounts → Create discount**](https://help.shopify.com/en/manual/discounts/discount-types/percentage-fixed-amount) and choose **Amount off products**, then set the **Method** to **Automatic**. For our example, enter:

* **Discount value** — `10%` off
* **Applies to** — the **Men's hiking** collection
* **Minimum requirement** — Minimum quantity of items → `3`

Save it, and note the values — you re-enter them in the theme so the preview matches.

![Creating a 10%-off automatic discount in Shopify admin](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-dd1a6abbdf1356cacccfbbe2a4710a7b85f51338%2Fhow-to-bundle-builder-discount.png?alt=media)

***

## Step 2 — Match the discount in the Bundle summary block

Add the **Bundle builder** section, open the **Bundle summary** block → **Discount settings**, and enter the same numbers as the discount above:

* **Discount type** — Amount of products
* **Discount method** — Percentage
* **Label** — `Save 10%` (the text customers see)
* **Discount percentage** — `10`
* **Minimum requirement** — Quantity of items
* **Minimum quantity** — `3`

![Matching the discount in the Bundle summary block](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-88c0583ee36a28f62a6b950c4594aaf4577ad853%2Fhow-to-bundle-builder-summary-block.png?alt=media)

{% hint style="info" %}
For multi-tier savings (for example, 10% at 3 items and 15% at 5), create one Shopify automatic discount per threshold, then enable **Tier 2** and **Tier 3** and mirror each one here.
{% endhint %}

***

## Step 3 — Point the product list at the right products

In the **Product list** block, set the **Collection** to **Men's hiking** — the same collection the Shopify discount applies to — so only eligible items appear in the builder.

![Pointing the Product list block at the Men's hiking collection](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-0c3882e307b77e1e1ae9e458f394bea841f9e111%2Fhow-to-bundle-builder-product-list.png?alt=media)

***

## Result

On the storefront, a customer adds products to the bundle. Once they reach **3 items**, the summary shows the **Save 10%** label and the discounted total updates live.

![Storefront bundle builder showing the 10% saving applied](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-7ceade6bf4fd861c456e72ab29253fbc384add3b%2Fhow-to-bundle-builder-result.png?alt=media)

When the bundle is added to the cart, the Shopify automatic discount applies the real 10% — matching the previewed saving exactly.

![Cart showing the same 10% discount applied](https://3215967854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlyCMfKbEVTf3hu8uxjSZ%2Fuploads%2Fgit-blob-2dc6cd00c528b4b823b33d9281c4d62a4558a889%2Fhow-to-bundle-builder-result-cart.png?alt=media)

{% hint style="info" %}
The tier settings only preview the price as the bundle is built. The actual saving is always applied by the Shopify automatic discount at checkout.
{% endhint %}

***

{% hint style="info" icon="headset" %}
**Need help?**

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

<a href="https://go.crisp.chat/chat/embed/?website_id=6c25581e-794a-41b4-8552-52f3de1dd1f7" class="button secondary" data-icon="comments">Chat with us</a> <a href="https://modutheme.ticksy.com" class="button primary" data-icon="ticket">Submit a ticket</a>
{% endhint %}