> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/section/bundle-builder.md).

# Bundle builder

Let shoppers build their own bundle from a product grid, with a live summary that shows tier progress, the total and the savings.

The Bundle builder section lets shoppers pick several products from a grid and add them all to the cart in one click. A summary panel next to the grid lists the chosen items and shows a progress bar toward your discount tiers, the bundle total and how much the shopper saves. Use it for "mix and match" or "buy more, save more" offers.

Shoppers click **Add to bundle** on a product card, then use the + and – buttons to change the quantity. For products with several variants, the variant is chosen from a dropdown inside the summary panel.

### 1. How to add the section

In the theme editor, click **Add section** and choose **Bundle builder** (in the **Products** category). The section is added with three example discount tiers.

### 2. Section settings

**General**

* **Collection:** show the products from this collection in the grid.
* **Products:** pick up to 16 products by hand. When you select products here, they replace the collection.
* **Maximum items in bundle:** the most items a shopper can add in total, across all products. Set to 0 for no limit (range 0–20).
* **Products per row on desktop:** 2 to 4.
* **Products per row on mobile:** 1 column or 2 columns.

**Product card**

* **Image ratio:** Adapt to image, Portrait or Square.
* **Show vendor:** shows the product vendor on each card.
* **Show product rating:** shows the star rating on each card. To display a rating, you need a product reviews app.
* **“Add to bundle” button style:** Solid or Outline.

**Summary panel**

* **Panel title:** the heading of the summary panel, for example "Your bundle".
* **“Add to cart” button:** the text of the button that adds the whole bundle to the cart.
* **Button style:** Solid or Outline.
* **Enable sticky summary on mobile:** shows a compact bundle bar with the progress fixed to the bottom of the screen while shoppers scroll through the section. Tapping the bar opens the full summary.

**Colors**

* **Color scheme:** applies to the summary panel only.
* **Button color scheme:** the color scheme of the "Add to bundle" and "Add to cart" buttons.
* **Progress bar:** the fill color of the tier progress bar.

{% hint style="info" %}
**Note:** Padding, section width, section header and color settings work the same in every section. See [Common settings](https://help.byinspiredlabs.com/section/common-settings.md).
{% endhint %}

### 3. Block settings

Each **Discount tier** block adds one step to the progress bar. You can add up to 5 tiers.

* **Minimum quantity:** the total number of items needed to reach this tier (2–20).
* **Discount %:** the discount shown for this tier (1–60%).

As shoppers add items, the panel tells them how many more they need to reach the next tier, and shows the discounted price and savings once a tier is reached.

{% hint style="warning" %}
**Important:** The discount tiers only **display** the savings in the bundle builder. They don't apply a discount by themselves. To give shoppers the discount at checkout, create matching automatic discounts in **Discounts** in your Shopify admin, using the same quantities and percentages. See [Bundle discounts](https://help.byinspiredlabs.com/others/faqs/how-do-i-set-up-bundle-discounts.md) for step-by-step instructions.
{% endhint %}

{% hint style="info" %}
**Note:** The "Add to cart" button follows your **Cart type** setting: it opens the cart drawer or notification, or goes to the cart page. See [Cart](https://help.byinspiredlabs.com/theme-settings/cart.md).
{% endhint %}
