> For the complete documentation index, see [llms.txt](https://docs.tipo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tipo.io/bundle-groups/create-a-new-bundle-group.md).

# 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&#x20;

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.
