> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Shared Inventory Tracking

> Track stock across multiple storekit products that share an ingredient using a shared modifier. When the modifier runs out, every linked product sells out.

When you have a limited ingredient or component that's used across multiple products, you can track its inventory in one place using a shared modifier. When stock runs out, all products using that modifier automatically become unavailable.

## Use Cases

* **Pizza dough** - Track total pizzas you can make across all pizza types
* **Bread rolls** - Limit total burgers/sandwiches available
* **Daily prep items** - Soups, sauces, or specials with limited quantities
* **Seasonal ingredients** - Track a scarce ingredient across dishes

## How It Works

1. Create a modifier group representing your limited ingredient
2. Add a single option with inventory tracking enabled
3. Attach this modifier to all products that use the ingredient
4. Make it required and pre-selected so it's invisible to customers
5. When inventory reaches zero, all linked products become unavailable

## Step-by-Step Setup

### 1. Create the Modifier Group

1. Go to **Menu** and select a product that uses the ingredient
2. Open the **Modifiers** tab
3. Click **Add Modifier Group**
4. Name it something descriptive (e.g., "Pizza Dough", "Bread Roll")

### 2. Add the Stock Option

1. Click **Add an option**
2. Name it (e.g., "Regular Dough" or simply the ingredient name)
3. Set the price to **£0** (or your currency equivalent)
4. Toggle **Track Inventory** on
5. Enter your available stock count

### 3. Configure Selection Rules

Set the modifier to be required but invisible to customers:

| Setting             | Value     | Why                      |
| ------------------- | --------- | ------------------------ |
| **Min**             | 1         | Makes it required        |
| **Max**             | 1         | Only one can be selected |
| **Default Qty**     | 1         | Pre-selects the option   |
| **Initial Display** | Collapsed | Keeps it out of the way  |

### 4. Attach to Other Products

1. Open another product that uses the same ingredient
2. Go to the **Modifiers** tab
3. Click **Add Existing Group**
4. Select your stock modifier group

Repeat for all products that share this inventory.

## Example: Pizza Dough

You can make 50 pizzas per day. You have 5 pizza types on your menu.

**Setup:**

* Modifier group: "Pizza Base"
* Option: "Fresh Dough" - £0, inventory: 50
* Min: 1, Max: 1, Default Qty: 1
* Attached to: Margherita, Pepperoni, Hawaiian, Veggie, BBQ Chicken

**Result:**

* Each pizza order reduces the dough count by 1
* When count hits 0, all 5 pizzas show as unavailable
* Reset the count daily when you prep fresh dough

## Restocking

To restock:

1. Go to any product with the modifier
2. Open the modifier group
3. Update the inventory count
4. Click **Save Modifiers**

The change applies everywhere the modifier is used.

<Tip>
  Create a simple product called "Restock Items" in a hidden category. Attach all your stock modifiers to it for easy access when restocking.
</Tip>

## Tips

* **Name clearly** - Use names your team will understand when restocking
* **Set realistic counts** - Account for waste and mistakes
* **Reset daily** - For daily prep items, restock each morning
* **Use £0 pricing** - Keep the modifier invisible to customers
* **Collapsed display** - Customers don't need to see required pre-selected options