# Troubleshooting: Bundle Groups

### ✅ Before you start (quick checklist)

Check these first

* The bundle is set up as a **Bundle Group** (Master + Components saved)
* You selected the correct variants (not only product titles)
* **Track quantity** is enabled for all component variants in Shopify
* Component quantities are correct (×1, ×2, ×3…)
* You’re checking the correct Shopify location (if you use multiple locations)

***

### 🛠 Case 1: Cannot create Bundle Groups

If you cannot create a Bundle or Inventory Sync Group, make sure all required information is properly set up.

**Checklists:**

* The group must include at least 2 variants.

**Example**: 

A bundle with only one product variant (e.g., just “T-shirt Blue – Small”) cannot be created. You need at least two (e.g., “T-shirt Blue – Small” and “T-shirt Blue – Large”).

The group must have at least one active location, and that location’s inventory must not be blank.

**Example***:* 

If your “Main Warehouse” location has no inventory number entered, the system cannot calculate the initial stock for the group.

Each variant can belong to only one group.

***

### 🛠  **Case 2: Scan, Import, Export, or Report not working**

If your scan, import, export, or report function doesn’t start or seems stuck:

| Only one task can run at a time.     | Wait until the current background process is finished before starting a new one.                                                                                                                                                        | If you’re already importing a large CSV file, running a “Scan” at the same time will fail until the import is complete. |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| These actions run in the background. | You’ll receive an email notification once the task is complete.                                                                                                                                                                         | After running “Export Inventory Groups,” check your email inbox, the system will send a download link once it’s ready.  |
| Didn’t receive the email?            | <p>1. Check your email address in the app’s <strong>Settings</strong> tab to make sure it’s correct.<br> 2. Check your <strong>spam</strong> or <strong>promotions</strong> folder, some email providers filter task notifications.</p> | If you don’t see the export report email, look in the Spam folder or verify the address in Settings.                    |

***

### 🛠 Case 3: Unexpected Inventory Changes

If inventory numbers change unexpectedly between Master and Component products, it’s usually due to a triggered sync event.

We suggest you open the **History** tab in the app to review which event caused the change.\
**Example***:* You may see that inventory for “Bundle A” decreased because an order containing “Master Product A” was created.

**Note:**\
History records are automatically deleted after **2 months**, so older changes will no longer appear.

If you suspect a sync loop or unexpected adjustment, try reviewing recent orders or edits made through third-party apps that might have modified stock quantities.

***

### 🛠  Case 4: Bundle (Master) inventory is 0 but components have stock

#### Why it happens

**Why it happens (Most often)**

* A component is out of stock at the tracked location
* Component quantity is set incorrectly (e.g., should be ×2)
* Inventory tracking is disabled for a component variant

**How to solve**

1. Open the Bundle Group and confirm each **component variant**
2. Check component inventory in Shopify and ensure **Track quantity** is enabled
3. Confirm quantities required per bundle are correct
4. Run **Update Master Inventory** to recalculate

✅ Example: If a bundle needs **2× Product A**, then Product A stock limits the bundle.

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