# Create a new Bundle Group

Bundle Groups help you keep bundle inventory accurate by linking a **Bundle product (Master)** with the items inside it (**Components**). When the bundle sells, Tipo updates the component inventory automatically.

### ✅ Before you start

Make sure:

* Your **Bundle (Master)** product already exists in Shopify
* Your **Component** products exist and have **Track quantity** enabled
* You know how many units of each component are required for 1 bundle

***

### 🛠️ Steps to manage 

1. Open the app > click **Bundle Groups** >  click **New** **Bundle Group** button
2. Enter a **Title** and select **Status** as **Active**

<figure><img src="/files/gLYILaiCpvivlw1f9ggC" alt=""><figcaption></figcaption></figure>

3. Add Variants to the Group. There are 2 ways to add variants:

You can add variants using two methods:

* **Manual select:** Choose specific product variants from your catalog.

<figure><img src="/files/ArVDcwrZOFHQqNyThRlu" alt=""><figcaption></figcaption></figure>

* **Smart select:** Use filters (e.g., Title, Price, Vendor, Tag, Product Type, or Collection) to find and select multiple variants at once.\
  Example: Filter by *Tag contains “g90”* to quickly select all related variants.

<figure><img src="/files/qIX0hjE6hbF25UsQA2xN" alt=""><figcaption></figcaption></figure>

4. Set Bundle quantities: assign a **Master Variant** (main item controlling inventory sync) and set the **Bundle Quantity** for each.\
   This determines how many units of each variant are linked in the bundle.

<figure><img src="/files/bu15ONHGsy41WSn96tM3" alt=""><figcaption></figcaption></figure>

5. Save the bundle group.&#x20;

***

### 🔄 How Bundle Groups work

#### How the app calculates bundle availability

A bundle’s available quantity is based on the lowest available component stock, considering the quantity required.

**Formula (simple):**\
Bundle available = min( Component stock ÷ Quantity required )

#### What happens when a bundle is sold?

When an order is created for the Master product:

* Tipo app deducts inventory from each component based on its required quantity
* The bundle availability updates automatically after component stock changes

#### Example

**Bundle setup**

**Master (Bundle):** Gift Box Set\
**Components:**

* Candle × 1
* Gift Box × 1

**Inventory before sale**

* Candle: 20
* Gift Box: 12

✅ Bundle availability = **12** (Gift Box is the lowest)

#### Customer buys 2 bundles

Tipo Sync updates components:

* Candle: 20 → 18
* Gift Box: 12 → 10

✅ Bundle availability becomes **10**

**🙋 Still need support?**

If you still need help, please feel free to contact us at <hi@tipo.io>. We’ll be happy to assist you further.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tipo.io/bundle-groups/create-a-new-bundle-group.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.