Creating your first Modifier Blueprint

A Modifier Blueprint tells Stash what to deduct (and optionally what to swap back) when a customer adds a modifier to their order — Oat Milk, Extra Shot, Premium Gift Wrap, Decaf, Monogramming.

If you haven't read it yet, What is a Modifier Blueprint? explains why this is a separate concept from a regular Blueprint and the math behind the swap.

Who can do this

Only Admins can create or edit Modifier Blueprints. Members can view them.

Before you start

You need at least one location set up
The components and any swap target items must already exist in Inventory at the same shop
For best results, your base Blueprints should already exist for the drinks/products that use the swap target — otherwise the swap won't fire on those orders

Step-by-step

From the sidebar, open Blueprints.
Click the Modifier Blueprints tab.
Click + New Modifier Blueprint.
Enter a Name matching what your POS calls this modifier (Oat Milk, Extra Shot, Premium Wrap, etc.).
Select the Location — which shop this Modifier Blueprint applies to.
Pick the POS Product that represents this modifier in your POS catalog. Without this, the Modifier Blueprint will never fire.
Under What this uses, add components to deduct when this modifier sells (e.g., 200ml of Oat Milk). This is optional if you only want to swap something out.
Under What this swaps out, optionally pick a single inventory item that this modifier replaces in the base recipe (e.g., Cow Milk, 200ml). Stash will add this back when the modifier sells alongside a base drink that deducted it.
Watch the live preview below the swap field — it confirms what will get added back.
Click Save.

That's it. The next time this modifier sells through your POS, Stash will deduct the components and apply the swap (if a base Blueprint deducted the swap target in the same order).

Examples for different verticals

Coffee shop — milk swap

Name: Oat Milk
POS Product: Oat Milk modifier
What this uses: 200ml Oat Milk
What this swaps out: 200ml Cow Milk

Coffee shop — pure addition (no swap)

Name: Extra Shot
POS Product: Extra Shot modifier
What this uses: 9g Coffee Beans
What this swaps out: (leave empty — nothing to replace)

Restaurant — bun swap

Name: Gluten-Free Bun
POS Product: GF Bun modifier
What this uses: 1 GF Bun
What this swaps out: 1 Brioche Bun

Retail — gift wrap upgrade

Name: Premium Gift Wrap
POS Product: Premium Wrap option
What this uses: 1 Premium Wrap Roll, 1 Ribbon
What this swaps out: 1 Standard Wrap Roll

When to use a swap and when not to

Use a swap when…	Skip the swap when…
This modifier replaces something the base recipe already deducts (oat milk replaces cow milk)	This modifier is a pure addition (extra shot, whipped cream, side of fries)
You need inventory math to balance out (the customer used X instead of Y)	The base recipe doesn't deduct anything that this modifier replaces

What "Makes" means on a Modifier Blueprint

For most modifiers, leave Makes at 1. Modifiers are typically sold one-to-one with the base item. The Makes field is collapsed under "Advanced" because it rarely needs changing.

Common mistakes to avoid

Setting a swap with no base Blueprint that uses the swap target

If you create an Oat Milk Modifier Blueprint that swaps Cow Milk, but you don't have any Latte / Cappuccino / Flat White Blueprints set up that use Cow Milk as a component, the swap will never fire. The Modifier Blueprint will still deduct Oat Milk correctly — but Cow Milk won't be added back, because nothing deducted it.

Fix: Set up Blueprints for your base drinks first, then create Modifier Blueprints for the swaps.

Creating a Modifier Blueprint for something that's actually a base product

If your "modifier" is something a customer can order on its own (a side of fries, a bottled drink, a standalone item), it's not really a modifier — it's a base product. Use a regular Blueprint instead, on the Blueprints tab.

Forgetting the POS Product link

A Modifier Blueprint without a POS Product link does nothing on sale. Always link it to the modifier as it appears in your POS.

Picking a swap target from a different shop

Modifier Blueprints are scoped to a single shop. The swap target item must exist at the same shop. Stash will block this at save time.

Editing later

You can edit a Modifier Blueprint at any time. Changes apply to future sales only — past inventory transactions stay as they are. Same as regular Blueprints. See Editing or deleting a Blueprint.

Converting between Blueprint and Modifier Blueprint

If you created the wrong type, you can convert between them. Open the Blueprint or Modifier Blueprint, click the menu (⋯), and choose Convert to [other type]. Going from Modifier Blueprint to Blueprint will clear the swap configuration after a confirmation prompt.