> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomwize.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Bundles

> Add quantity breaks, BOGO and bundle offers to your product pages.

Bundles add quantity breaks, BOGO and bundle offers to your product pages. Discounts apply automatically at checkout.

![Bundles page with a list of deals](https://assets.ecomwize.io/docs/shots/bundles.png)

## Create a bundle

**1. Open Bundles**

In EcomWize, click **Bundles** in the left sidebar (under Apps).

**2. Start a deal**

Click **Create a bundle** and pick a type.

**3. Set it up**

Choose which products it applies to, edit the options and styling, then save.

## Choose a bundle type

| Type | What shoppers get |
| - | - |
| **Quantity breaks** | A better price when they buy more. |
| **Buy X, get Y free (BOGO)** | Free items when they buy a set amount. |
| **Complete the bundle** | Companion products to add alongside the main one. |

## Bundle settings

* **Visibility**: turn the deal on or off.
* **Applies to**: **All products**, **Specific products** or **Specific collection**.
* **Bundle name**: up to 30 characters. Only you see it.
* **Heading**: shown above the options. The default is "BUY MORE & SAVE".
* **Options**: each has a title, subtext (for example `You save {{saved_percentage}}`), selected by default, image and badges.
* **Gifts**: a free product or free shipping.
* **Discount name**: shown at cart and checkout.
* Variant picker, fonts and colors.

![The bundle editor with its settings and live preview](https://assets.ecomwize.io/docs/shots/bundles-editor.png)

## Show bundles on your theme

On your theme's product page, add the app block **EcomWize Bundles**. The app embed must be on. The first enabled deal that matches the product shows.

## Show bundles on EcomWize pages

Buy boxes on your EcomWize pages show your bundle. In the builder, select the buy box and open the **EcomWize bundle** panel. Set **Bundle** to **Automatic** or a specific deal. Click **Manage bundles** to edit your deals.

![A buy box with the bundle widget and the EcomWize bundle panel](https://assets.ecomwize.io/docs/shots/bundle-widget-crop.png)

![Product page with a bundle offer in the buy box](https://assets.ecomwize.io/docs/shots/bundle-builder.png)

## Add a mix-and-match bundle builder

A bundle builder lets shoppers pick their own items, with tiers by item count and one add to cart. Ask the AI agent to add one to your page. It reuses a matching deal or creates a new one.

## Limits

| Limit | Value |
| - | - |
| Deals per store | 50 |
| Options per deal | 6 |

## Plans

Bundles are included on Starter, Pro and Max.

## Related

> **[Cart drawer](https://docs.ecomwize.io/sell/cart-drawer.md)**
>
> Rewards and upsells in the cart.

> **[App embed](https://docs.ecomwize.io/publish/app-embed.md)**
>
> Required for bundles on your theme.

> **[AI agent](https://docs.ecomwize.io/builder/ai-agent.md)**
>
> Ask for a bundle builder.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.