What is a Modifier Blueprint?

A Modifier Blueprint in Stash is a recipe for a POS modifier — the extras and upgrades a customer adds to their order. Examples: Oat Milk, Extra Shot, Gluten-Free Bun, Premium Gift Wrap, Monogramming, Larger Size.

Where a regular Blueprint says "when a Latte sells, deduct these components," a Modifier Blueprint says "when an Oat Milk modifier sells, deduct oat milk — and add back the cow milk that the base drink would have used."

Modifier Blueprint vs Blueprint — the difference

Blueprint	Modifier Blueprint
For products customers order on their own — a drink, a dish, a gift box, a kit, a bundle	For modifiers customers add to a base product — oat milk, extra shot, gift wrap, free sample
Has components ("What this uses")	Has components AND optionally a swap ("What this swaps out")
Examples: Latte, Cappuccino, Burger, Holiday Gift Box	Examples: Oat Milk, Extra Shot, Premium Wrap, Monogramming

Why Modifier Blueprints exist as their own thing

Most POS systems sell modifiers as separate line items on the order. When a customer orders "Latte with Oat Milk," your POS sends two lines: Latte and Oat Milk. Each line is processed independently against its own Blueprint or Modifier Blueprint.

Without a Modifier Blueprint, the Latte's Blueprint deducts cow milk (its default), and the Oat Milk line just sits there with nothing to do. Your inventory ends up wrong: cow milk over-deducted, oat milk untouched.

A Modifier Blueprint fixes that with two pieces:

What this uses — the modifier's own components (e.g., 200ml of Oat Milk)
What this swaps out — the item from the base recipe that this modifier replaces (e.g., 200ml of Cow Milk)

When the modifier sells, Stash deducts the oat milk and adds back the cow milk in the same order. Net result: cow milk untouched, oat milk deducted. Inventory matches reality.

What's inside a Modifier Blueprint?

Name — what your POS calls the modifier (Oat Milk, Extra Shot, etc.)
Location — which shop this Modifier Blueprint applies to
POS Product — the modifier line item in your POS that triggers this
What this uses — components to deduct when the modifier sells (optional)
What this swaps out — single item + quantity to add back when this modifier fires alongside a base Blueprint that deducted it (optional)

A Modifier Blueprint must have at least one component OR a swap configured. Empty Modifier Blueprints aren't allowed.

Why this scales — the math

If you offer 30 drinks and 4 milk options, the naïve approach would be to create a Blueprint for every combination: 30 × 4 = 120 Blueprints. That's a maintenance nightmare every time you add a drink or a milk.

With Modifier Blueprints, you create:

30 Blueprints for the base drinks (each with cow milk as the default component)
3 Modifier Blueprints (Oat, Almond, Soy) — each swaps cow milk for its own milk type

Total: 33 Blueprints. Add a 4th milk option later? +1 Modifier Blueprint, not +30.

How the swap math works

The swap follows a cap rule that prevents inventory errors.

Scenario A — Latte + Oat Milk modifier:

Latte Blueprint deducts: 18g coffee, 200ml cow milk, 1 cup
Oat Milk Modifier Blueprint deducts: 200ml oat milk
Oat Milk Modifier Blueprint adds back: 200ml cow milk
Net: 18g coffee, 200ml oat milk, 1 cup. ✅ Cow milk untouched.

Scenario B — Oat Milk modifier alone (no base drink):

Oat Milk Modifier Blueprint deducts: 200ml oat milk
Swap is skipped — no base deduction to reverse
Net: 200ml oat milk. ✅ No phantom cow milk added from nowhere.

Scenario C — 1 Latte + 2 Oat Milk modifiers:

Latte deducts: 200ml cow milk
Modifier deducts: 400ml oat milk total
Swap caps at 200ml (the amount actually deducted from base)
Net: 0ml cow milk change, 400ml oat milk deducted. ✅ Capped — no phantom cow milk added.

When the swap will fire — and when it won't

The swap on a Modifier Blueprint only fires when a base Blueprint in the same order actually deducts the swap target. This is by design — it prevents creating phantom inventory.

If you create a Modifier Blueprint for Oat Milk that swaps Cow Milk, but you have no Blueprints in that shop that use Cow Milk as a component, the swap will never fire (only the oat milk deduction will happen). The fix is to set up Blueprints for your base drinks first.

Permissions

Both Admins and Members can view Modifier Blueprints. Only Admins can create, edit, or delete them.

Where to find them

Open Blueprints from the sidebar. The page has two tabs: Blueprints and Modifier Blueprints. The Modifier Blueprints tab lists all your modifiers and lets you create new ones with the + New Modifier Blueprint button.