# Bundle Groups Overview

### ℹ️ What is a Bundle Group?

A **Bundle Group** links a **Master product (bundle)** with one or more **Component products**.\
When inventory changes (for example, a bundle is sold or components are restocked), Tipo app updates inventory based on your bundle rules.

***

### ℹ️ When should I use Bundle Groups?

Use Bundle Groups if you sell:

* **Kits / bundles** (e.g., “Gift Set” contains 1 candle + 1 box)
* **Packs** (e.g., “3-Pack Socks” consumes 3 units of the same SKU)
* **Build-your-own sets** where the master item depends on components

***

### 🔑 Key terms

*  **Master product**: the bundle listing customers buy (e.g., “Gift Box Set”)
* **Component products**: the items inside the bundle (e.g., “Candle”, “Box”)
* **Quantity rule**: how many units of each component are required for 1 bundle

***

### ✅ How Bundle inventory works

Tipo keeps inventory accurate by:

* Reducing component inventory when the **Master** sells
* Updating Master availability based on **component stock**
* Preventing overselling when a component is out of stock (depending on your rule setup)

***

### 🧪 Example

Let’s say you sell a bundle:

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

* Candle (needs **1**)
* Gift Box (needs **1**)

**Inventory before sale**

* Candle: 20
* Gift Box: 12\
  ✅ Bundle can be sold **12** times (limited by the lowest component)

**After 2 bundle sales**

* Candle becomes 18
* Gift Box becomes 10\
  ✅ Bundle availability becomes **10**

***

### ℹ️ What affects syncing?

Bundle updates can happen when:

*  An order is created (bundle sold)
* An order is refunded/cancelled (inventory returned)
* You edit the Bundle Group settings/rules

**🙋 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/bundle-groups-overview.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.