Skip to main content

Modifier Mapper

The Modifier Mapper does for your till's modifiers what the Item Mapper does for its menu items. A modifier is an option added to an item at the till, such as "Oat milk", "Extra shot" or "No cheese". Give a modifier a recipe and Brikly knows what it adds to the cost of the item, and which allergens it brings.

Open it from Modifier Mapper in the sidebar, under your till's name (for example Square). It needs a connected till and CostingBrik.

What you see​

Modifiers are grouped by the modifier list they belong to on your till, for example "Milk options" or "Extras". Click a group to open it. Each group shows how far along it is, for example "4/6 built", where modifiers marked as not needing a recipe count as done.

Each modifier shows:

  • an amber Needs recipe tag while it still needs a recipe, Built once it has one, or No recipe needed once you have marked it;
  • for a built modifier, its type: Addition, Removal or Swap;
  • whether it is Active or Hidden;
  • what it adds to the item's cost, or saves for a removal, and its portion.

Above the list, a count shows how many modifiers are configured and how many still need recipes. Use the Active only / All modifiers toggle to choose which modifiers to show.

Syncing your modifiers​

Click Sync from Square (the button is named after your till) to pull in modifiers you have added since. If the list is empty when an owner, admin or member opens it with a till connected, Brikly syncs on its own.

Building a recipe for a modifier​

Click Build on a modifier, or Edit once it has a recipe, to open its page. Choose what kind of modifier it is:

  • Addition - adds ingredients, such as an extra shot or a vanilla syrup.
  • Removal - takes an ingredient away, such as "No cheese".
  • Swap - replaces one ingredient with another, such as oat milk instead of whole milk.

Add its ingredients and click Save recipe.

Once an addition or swap has a recipe, its allergens come from that recipe's ingredients, and it shows on the SafetyBrik allergen matrix under Add-ons and swaps. Removals are not listed there, because their recipe is what comes off the item.

When the amount differs by menu item​

If the amount differs from one menu item to another, for example more oat milk in a large latte than in a small one, choose Varies by menu item under Quantity configuration. Pick the ingredient (no amount needed yet) and click Next: set quantities per item.

Varies by menu item works with one ingredient, not several or a sub-recipe. For a modifier like that, choose Same for all items, then change the amount on a single menu item from that recipe's Modifiers tab.

The next screen, Set quantities per menu item, lists every menu item linked to the modifier, each starting with the amount already saved for it:

  • For a swap, a column shows how much of the ingredient being replaced each recipe uses. Match copies that amount for a straight one-for-one swap, and Match all does it for every row. A drink without the ingredient being replaced starts at 0 and shows Not used.
  • A menu item left empty uses the typical (median) amount, and the screen says so before you save, for example "2 menu items left empty will use the typical amount, 250 ml".
  • An amount more than 100 times the typical one is refused, with a message naming the menu item and asking you to check the unit (for example grams against kilograms).

When you save, Brikly saves the median of the amounts (leaving out any at 0) as the modifier's standard amount, and each menu item's own amount alongside it.

A modifier that already has its own amounts​

A modifier that already has its own amount on some menu items opens on Varies by menu item, and the page says how many, for example "This modifier has its own amount on 3 menu items. Changing the standard amount here does not change theirs."

If you save it with Same for all items instead, Brikly asks what to do with those amounts first:

  • Keep their amounts - each of those menu items keeps the amount it really uses, even though the standard amount changes.
  • One amount for every item - their own amounts are removed, and every menu item uses the new standard amount.

Cancel saves nothing.

Past sales are re-costed​

Saving amounts per menu item, or rebuilding a modifier that already had a recipe, re-costs that modifier's past sales at today's cost. So does setting or resetting one recipe's own amount on its Modifiers tab. This runs in the background and normally settles within a minute or two, so past modifier costs and margins in your reports can change.

How modifier costs reach your reports​

Once a modifier has a recipe, Brikly counts what it costs every time it is sold, in MenuBrik's modifier figures, the dashboards and the Brikly Connector:

  • an addition counts what it adds, a removal counts as a saving, and a swap counts what it adds less what it takes away;
  • where a menu item has its own amount of the modifier, that amount is used;
  • each item sold counts, so two lattes with oat milk on one till line cost two oat milks. Some sales from before 18 July 2026 count each till line once, because the till detail Brikly needs for them is no longer kept;
  • a hidden modifier stops counting.

How often an option is chosen, and its attachment rate, still count till lines, so they are not changed by this.

Menu items that drop out of the Item Mapper after a sync (on Square, archived or deleted on the till; on SumUp POS Pro, switched off on the till) drop out of the Modifier Mapper's menu items too, unless they are linked to a recipe. A SumUp POS Pro item that no longer appears in your till's menu at all, such as one you delete there, stays.

Modifiers that don't need a recipe​

Some modifiers add nothing to eat or drink: "Extra hot", "Well done", a grind size, a gift bag. Mark these as not needing a recipe, so they stop counting as needing one. There are three ways:

  • In the list, click the no-entry icon on the modifier's row and confirm Mark as no recipe needed. This marks that one modifier.
  • On the modifier's page, click Skip: no recipe needed.
  • On a recipe's Modifiers tab, click Skip on the modifier.

To undo it, click the same icon on the row and choose Require recipe, or click Undo on the modifier in a recipe's Modifiers tab.

What this does to the allergen matrix​

Until it has a recipe, an active add-on is listed on the allergen matrix and the kiosk as not fully known, so staff and guests are told to ask the kitchen (see Add-ons with no recipe). Marking it as not needing a recipe takes it off the matrix straight away. Unmarking it puts it back.

So only mark a modifier that adds no ingredients. A syrup, "Add butter" or "Add cream" needs a recipe: build one, and the matrix shows its allergens instead. Both the skip panel and the confirmation say so.

Modifiers with the same name​

The allergen matrix shows add-ons with no recipe once per name. If "Caramel Syrup" is on three of your modifier lists, the matrix has one "Caramel Syrup" row, and it stays until every one of the three has a recipe or is marked as not needing one.

When other modifiers with no recipe share the name, the skip panel on the modifier's page shows a tick box, for example "Also mark the 2 other modifiers with the same name that have no recipe."

  • If you came from the allergen matrix, through the row's Link a recipe, or mark it as not needing one link or its Not fully known badge, the box is already ticked, so one click on Skip: no recipe needed clears the whole row.
  • If you opened the page from the Modifier Mapper list, the box starts unticked, and only this modifier is marked unless you tick it.

Marking a modifier from the icon on its row in the list always marks just that one.

When the box is ticked, the message afterwards names how many others were marked, for example ""Caramel Syrup" and 2 other modifiers with the same name marked as no recipe needed".

After you build a recipe for an add-on, the matrix shows it with the recipe's allergens, normally within a minute.

Hiding modifiers​

Click the eye icon on a modifier to hide one you no longer sell, or the eye icon on a group to hide every modifier in it. If some of the group's modifiers are built and costed, the confirmation says how many, because a hidden modifier stops counting in modifier costs.

Switch the toggle to All modifiers to see hidden ones. Unhide one with its eye icon, or a whole hidden group with the eye icon on the group (Unhide all).

A hidden modifier is not listed on the allergen matrix either, so only hide modifiers you no longer sell.

On a recipe's Modifiers tab​

A recipe linked to a till item has a Modifiers tab, listing the modifiers that item can take with a summary such as "6 modifiers linked | 4 costed | 1 no recipe needed". A modifier marked as not needing a recipe is counted on its own, not as costed.

Each costed modifier shows its cost at the standard amount: an addition with a plus sign, a removal as a saving in green with a minus sign, and a swap as what it adds less what it takes away. Owners, admins and members can change them:

  • Override sets this recipe's own amount of the modifier, for example more oat milk in a large latte. The box opens with the exact amount saved (12.25 stays 12.25). Press Enter or click away to save it. Escape closes the box without saving, and an amount you did not change is not saved again.
  • Reset removes this recipe's own amount, so it goes back to the standard amount.
  • Set qty shows on a modifier added automatically when the recipe was linked, marked Review, until you enter the right amount for this recipe.
  • Build and Skip show on a modifier with no recipe. A skipped one shows No recipe needed and offers Undo.

An amount more than 100 times the modifier's standard amount is refused: "That is more than 100 times this modifier's standard amount. Check the unit (for example grams against kilograms) and try again."

Permissions​

Viewers can see the Modifier Mapper. Syncing, building recipes, marking modifiers and hiding them need edit access (owner, admin or member).