> For the complete documentation index, see [llms.txt](https://oranthemes.gitbook.io/edge-theme/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oranthemes.gitbook.io/edge-theme/theme-sections/products/bundle-builder.md).

# Bundle builder

Let customers build their own bundle from a collection and save with a discount code

The "Bundle builder" section lets customers pick products from a collection, see how much they save, and add the whole bundle to the cart in one click. A discount code is applied to the cart automatically.

<figure><img src="https://2841038207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGTidUfSjAqopf8pRRmN%2Fuploads%2Fgit-blob-8cbe7702facfe8232b73c3578c85b5cb95c6d0e8%2Fbundle-builder.jpg?alt=media" alt="Bundle builder"><figcaption></figcaption></figure>

{% hint style="success" %}
**Steps:**

1. In the theme editor **(Customize)**, click **Add section.**
2. Locate **Bundle builder.**
3. Make necessary changes. > **Save.**
   {% endhint %}

## How it works

1. Customers choose a variant and click **Add to bundle** on the products they like.
2. The summary on the right shows the selected products, their quantity and the total. On mobile, the summary is shown at the bottom of the screen and can be expanded.
3. When customers reach the **Minimum products**, the discount is shown and the **Add all to cart** button becomes available.
4. Clicking **Add all to cart** adds all products to the cart and applies the **Discount code**.

{% hint style="info" %}
**Minimum products** and **Maximum products** count different products, not quantities. Customers can increase the quantity of each product in the summary.
{% endhint %}

## General settings

<figure><img src="https://2841038207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGTidUfSjAqopf8pRRmN%2Fuploads%2Fgit-blob-66ed5b52c4694c851597df9b2745d172226df6ae%2Fbundle-builder-settings.jpg?alt=media" alt="Bundle builder settings" width="304"><figcaption></figcaption></figure>

### Section header

* **Subheading**
* **Heading**
* **Heading size** - Heading 1 - Heading 6
* **Description**
* **Layout** - Horizontal / Vertical

### Products

* **Collection** - Products customers can choose from
* **Products to show** - From 3 - 24
* **Minimum products** - The number of products needed to complete the bundle
* **Maximum products** - The maximum number of products in a bundle

### Discount

* **Discount code** - Applied to the cart when the bundle is added. Leave blank to sell the bundle without a discount.
* **Discount type** - Percentage / Fixed amount
* **Discount value** - Percentage: 20 = 20%. Fixed amount: 20 = 20 in your store currency, taken off the bundle total.

{% hint style="warning" %}
**Create the discount code first.** Go to **Discounts** in your Shopify admin and create a discount code with the same code and value. The section only shows the expected saving, the real discount is calculated by Shopify at checkout.

Because the code can be seen in the page source, limit it to the bundle collection and set a minimum quantity, for example **Minimum quantity of items: 3**.
{% endhint %}

{% hint style="info" %}
Applying the bundle discount code replaces any discount code already in the cart.
{% endhint %}

### Summary

* **Heading** - Leave blank to use "Build your bundle".
* **Heading alignment** - Left / Center

### Colors

* **Background**
* **Text**
* **Border**

### Section padding

* **Top padding**
* **Bottom padding**

### Section divider

* **Show top divider**
* **Show bottom divider**

{% hint style="info" %}
Pre-order products in the bundle are added with the **Pre-order: Yes** line, the same as on the product page. See [How to setup pre-order products?](https://oranthemes.gitbook.io/edge-theme/faqs/how-to-setup-pre-order-products.md)
{% endhint %}
