Modifier Inventory
Overview
Modifiers are the add-ons and options on a product — an extra shot, oat milk, a choice of sauce. Modifier Inventory lets a modifier carry its own stock count, so an add-on can sell out independently of the product it belongs to.
For example, your coffee never runs out, but oat milk might — modifier inventory handles exactly that.
How it works
- Each modifier option (a "modifier value") can have stock tracking turned on.
- When a sale includes that modifier, its count goes down.
- At zero or below, the modifier shows as sold out and can't be added.
- Stock can be a single shared count, or set per outlet.
Default setup
Bean & Brew example: track oat milk so it can sell out without affecting coffee.
- Open Stock Control → Modifier Values and edit the modifier (e.g.
Oat Milk). - Turn on Track quantity.
- Set Remaining quantity to your current count.
- Save.
Advanced options
| Field / feature | What it does |
|---|---|
| Allow return modifier inventory on void | A voided sale returns the modifier stock. |
| Code / Code type | A scan code for the modifier (Normal or Machine QR). |
| Per-outlet stock | Stock Control → Modifier Inventory lets each outlet override a modifier's stock count, instead of using the shared one. |
| Modifier transactions ledger | Stock Control → Modifier Transactions is a read-only history of every modifier stock movement. |
Master modifier values
A master modifier value is a reusable modifier option held in a central catalog, so the same add-on (e.g. Oat Milk) can be shared across many products instead of re-typed on each one. When you update the master value, every product's modifier option that links to it stays in sync.
Open Stock Control → Master Modifier Values (/master-modifier-values) to manage the catalog. Each entry is created and edited through its own form, and the list includes a bulk assign products action that opens a screen where you attach one master modifier value to many products at once.
To use a master value on a product, open the product editor, find the modifier group, and link the option to a Master Modifier Value (or to an Ingredient Bundle for recipe-based deduction).
When to use master modifier values
Reach for the catalog when the same add-on appears on lots of products. Define it once, bulk-assign it, and manage its stock in a single place rather than per product.
Master modifier inventory
Once a modifier option links to a master value, its stock is tracked per outlet through two screens:
| Screen | What it does |
|---|---|
Stock Control → Master Modifier Inventory (/master-modifier-inventory) | Per-outlet stock for each master modifier value (the entry uses inventory control type modifier). |
Stock Control → Modifier Inventory Transactions (/modifier-inventory-transactions) | A read-only history of every stock movement for master modifier values. |
Two ledgers, same idea
Modifier Transactions covers per-product modifier stock movements, while Modifier Inventory Transactions covers movements for shared master modifier values. Use whichever matches how the modifier was set up.
Related
- Inventory — the same idea for whole products.
- Products & Categories — where modifiers are attached to products.
- Stock Reports — reviewing modifier stock history.