# 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.