Skip to content

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 ​

  • Modifier stock is kept on master modifier values — the shared catalog of add-on options. That is the only place a modifier can carry a count.
  • A product's own modifier option holds no stock. Until you link it to a master modifier value it is never tracked and never sells out.
  • When a sale includes a linked option, the master value's count goes down by the option's quantity times the number of items — options chosen on items inside a combo count too.
  • At zero or below, the option is sold out: the POS and the kiosk show it as unavailable, and an order for it is refused.
  • Stock is checked only at the outlets ticked in the master value's Outlets.
  • Stock can be a single shared count, or set per outlet.

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. It is where the add-on's stock count is held, and switching it off turns the option off on every product that links to it. Each product's option keeps its own name, price and picture, though: renaming the master value does not rename the option on products that already use it. Edit the option on each product to rename it.

Open Stock Control › Master Modifier Values (/master-modifier-values) to manage the catalog. The list shows each value's code, outlets, stock, Cost and switches, and filters by Name, Outlets, Is Active, Is Track Quantity and Allow Return Modifier Inventory. Each entry is created and edited through its own form.

Default setup ​

Bean & Brew example: track oat milk so it can sell out without affecting coffee.

  1. Open Stock Control › Master Modifier Values and create or edit the value (e.g. Oat Milk).
  2. Tick the Outlets that sell it.
  3. Turn on Is Track Quantity.
  4. Set Remaining Quantity to your current count.
  5. Save.
  6. Link the products' options to it: in the product's Modifier panel, pick Oat Milk in the option's Master Modifier column — or link many products at once with Assign Products. For a group that comes from a Modifier Template, pick it in the template's Master modifier column instead.

Stock Control → Master Modifier Values → form

Link the option, or nothing is tracked

Step 6 is what connects the two. Skip it and the option keeps selling without ever reducing a count. To deduct an option's ingredients instead, use its Track Ingredients and Ingredient Bundles columns — see Ingredients & Recipes.

Advanced options ​

More fields on the Master Modifier Values form:

Field / featureWhat it does
Is ActiveSwitch off to stop the add-on being chosen on any product that links to it, until you switch it back on.
Allow Return Modifier InventoryA voided or cancelled sale returns the modifier stock.
OutletsThe outlets that sell it. Stock is checked, the add-on can sell out, and Is Active takes effect only at these outlets.
Code / Code TypeA code for the add-on, Normal or Machine QR. A Machine QR code is printed in the QR code on the kitchen chit of a product whose barcode type is Machine QR — see Products.
CostWhat one portion costs you, before tax, for cost of goods. For an option sold by amount (g, ml), enter the cost of one unit of that amount. Products using the add-on take this cost unless they set their own in the product's modifier Cost column.

Tick every outlet that sells it

At an outlet that isn't ticked in Outlets, the option never shows as sold out, but its sales there still count the shared stock down.

On an existing value, a box above the stock switches names the outlets that have their own row for it — Outlet inventory overrides — Custom stock limits are set for … — and how many of those rows are in use: Tracking: On for 2 outlets., or Tracking: Off (values saved but not enforced). when none has Control Inventory on. See list opens those Modifier Inventory rows, and Open goes straight to the row when there is only one.

Assign Products ​

The list icon at the end of a value's row opens Assign Products: one screen to link that master modifier value to the options of many products. It lists the single products sold at the value's Outlets, each with its modifier options grouped by modifier and the master modifier each option is linked to now.

  1. Narrow the list with Search, Categories, Assigned and Options.
  2. Tick the options to link — or use Select all for a modifier, Assign all options for a product, or Select all options for the page. Ticking an option replaces the master modifier it was linked to; unticking one linked to this value unlinks it.
  3. Click Save changes.

The value needs at least one outlet first; otherwise the screen says This master modifier value has no outlets. Options in a group that comes from a Modifier Template are skipped there — set their master modifier in the template.

Per-outlet stock and history ​

To give one outlet its own count for an add-on:

  1. Open Stock Control › Modifier Inventory (/master-modifier-inventory) and click Create.
  2. Choose the Outlet, then the Master Modifier Value — only values ticked for that outlet are offered. The form then says This outlet uses its own modifier inventory instead of Oat Milk.
  3. Turn on Control Inventory, then Track Quantity, and set Remaining Quantity. (Optional) Allow Return Inventory.
  4. Save.

Until Control Inventory is on, the outlet uses the master value's shared count, and with it on, the outlet's Allow Return Inventory decides returns there. An outlet's modifier count has no shift reset and no outlet price. The list, titled Modifier Inventory Overrides, filters by Outlet and Master Modifier Value. Only a merchant admin can delete a row; the outlet then goes back to the shared count.

ScreenWhat it does
Stock Control › Modifier InventoryPer-outlet stock for each master modifier value, so an outlet can override the shared count.
Stock Control › Modifier Inventory Transactions (/modifier-inventory-transactions)A read-only history of every modifier stock movement: Master Modifier, Receipt No, Type, Remaining Qty (Before), Qty, Remaining Qty, Reason, Employee and Created At. Filter by Outlet, Master Modifier, Type and Employee.

On the POS, the Inventory tab's Master Modifier sub-tab lists the values ticked for that outlet. Staff can switch Active and Track Quantity, and set the Remaining Quantity (0 or more). A new count goes to the outlet's own count where it keeps one — the sheet says This outlet keeps its own count — and to the shared count otherwise. Turning Active off asks first: it can't be chosen on any till until it is turned back on. Each new count saved there is recorded in Modifier Inventory Transactions as an adjustment (ADJ), with the reason POS and the staff member under Employee. See Master Modifier on the POS.