Skip to main content

Item Mapper

The Item Mapper connects your POS menu items to their recipes in CostingBrik. Once linked, each recipe gets the till's real selling price and its sales, so its margin uses what you actually charge and its yearly figures use what actually sells.

How it works​

When you connect a POS integration (e.g. Square), Brikly pulls in your full catalog of items and variations. The one exception is a Square variation marked as not sellable, such as a keg or a bottle of wine that your pint and glass variations draw down from: it is a stock unit rather than something you sell, so it is left out. The Item Mapper lets you:

  1. Browse your POS catalog - see every item and variation from your POS, organised by category.
  2. Build a recipe - create a new recipe directly from a POS item, pre-filled with the item name, price, and category.
  3. Link to an existing recipe - connect a POS item to a recipe you have already built.
  4. Track coverage - see at a glance how many of your POS items have linked recipes and your overall coverage percentage.

To cost your best sellers first, click Start a costing run: it lists your till items with no costed recipe yet, biggest sellers first, and moves you on to the next as you link each one. See Costing run.

Getting to the Item Mapper​

Navigate to Item Mapper from the sidebar. You will see:

  • Coverage stats at the top - total POS items, linked items, and your coverage percentage with a progress bar.
  • Items and Needs review tabs - the second one holds any linked items that have been renamed in your POS, with a count of how many are waiting.
  • Category pills - filter by POS category to focus on one section at a time.
  • Search bar - find specific items by name.
  • Item table - your POS items with actions to build, link, or view recipes, in name order.

The table loads your items 200 at a time. Load more under it shows the next 200, on All categories and inside a category. The count beside it, for example "Showing 200 of 512 items", counts every item that matches your current category, search and hidden items setting.

Coming from MenuBrik​

Most Link a recipe links in MenuBrik open the costing run. Two still open the Item Mapper: Change the start date, and Link a recipe on a row MenuBrik knows only by its recipe. If you open the Item Mapper from MenuBrik, a Back to Menu link (Back to Briefing from the Briefing, Back to Range review from Range review) at the top takes you back to exactly where you were. When you build a recipe from the Item Mapper, with Build or a renamed item's A new recipe, saving or cancelling brings you back to the Item Mapper as you left it, still with that way back.

Syncing your catalog​

On Square, items you add or change on your till usually reach the Item Mapper within a few minutes on their own. On SumUp POS Pro they arrive with the nightly sync. To pull in the latest changes straight away, click Sync catalogue. Brikly also syncs your catalogue every night. For a linked recipe the till sets the price: change it on your till, because a fixed till price replaces the recipe's price at the next sync, and you get a "POS price sync" notification listing the recipes whose price changed. An item with an open price leaves the recipe's price as it is. Syncing never removes existing links or hidden items.

On Square, an item you archive or delete on your till drops out of the Item Mapper, its search and the coverage figures after the next sync. On SumUp POS Pro, an item you switch off on the till drops out the same way, but an item that no longer appears in your till's menu at all, such as one you delete there, stays listed: hide it if you no longer need it. An item that drops out but is linked to a recipe stays listed with its link, so you can still see, change or unlink it, and its sales history keeps its recipe. An item you bring back on the till returns on the next sync.

If the connection to your till has expired, the sync stops and says so, and the Item Mapper shows a note with a link to Settings > Integrations, where you reconnect it. Sync catalogue comes back once the till is reconnected. See When a connection expires.

See what changed​

The "POS price sync" notification names each recipe whose price changed. Where the till item has several variations, the variation is shown in brackets, for example Dalston's (Elderflower). Press See what changed on the notification to open a summary of the sync:

  • Margin fell and Margin rose count the recipes whose GP% went down or up.
  • Profit at recent sales is what the new prices mean for your gross profit in a typical week, with a rough figure for a year.
  • For each recipe you see the old and new Price, Margin (GP%) and Profit per sale, and the change Per week with how many it sells a week. Click a recipe to open it.

On a phone, each recipe shows as a card with the same figures.

Profit per sale is the price without VAT minus the recipe's cost, the same basis as GP%, so before labour. Per week multiplies the change in profit per sale by the recipe's average sales over the last 4 full weeks, across all your sites. It is an estimate: a seasonal item, or one that has just gone on the menu, can sell differently from its last 4 weeks.

Example: Dalston's (Elderflower) goes from £2.95 to £2.90 on the till, with 20% VAT, so its price without VAT goes from £2.46 to £2.42. With a cost of £0.74, its profit per sale falls from £1.72 to £1.68, 4p less. It sold 13 in the last 4 weeks, about 3 a week, so the change is about 14p a week less.

A recipe with no cost, no previous price or no sales in the last 4 weeks shows a dash where a figure can't be worked out, and is left out of Profit at recent sales. Older notifications open the summary with prices and GP% only.

Coverage percentage​

Coverage shows what proportion of your POS items have a linked recipe. A higher percentage means more of your menu is being costed accurately.

The total and linked counts include only the items the Item Mapper lists: those it still has from your till, plus any that dropped out but still have a live link. So after a sync that drops archived items, the total can go down, while an item that dropped out but still has a live link stays counted as linked.

Focus on what matters

Not every POS item needs a recipe. Gift cards, merchandise, and service charges can be hidden from the Item Mapper so they do not drag down your coverage percentage.

Linking methods​

ActionWhen to use
BuildYou have not created a recipe yet. Opens the recipe builder pre-filled with the POS item details.
Link to existing recipeYou already have a recipe built. Opens a search modal to find and connect it, including recipes already linked to another till item (see One recipe on several till items).
ViewThe item is already linked. Opens the recipe for review.
Change recipeThe item is linked to the wrong recipe, or the date its costing starts from needs moving. Opens a Cost from date, set to today, with the current recipe offered so you can change only the date.
Unlink recipeYou need to stop costing an item against its recipe. Costing stops from tomorrow, and the history up to today keeps its recipe - the weeks and months already attributed are not restated.

One recipe on several till items​

The picker lists every active recipe, including ones already linked to another till item. Recipes named like the till item you are linking come first, then the rest. A recipe that is already linked says where, for example "Also on: Latte, Latte (Takeaway)", or "and 2 more" when it is on several.

One recipe can cost several till items. That is right when it is the same item under another button, such as a latte you ring up from two places on the till. When you pick a recipe that is already linked, a short note says so:

  • The same item under another button is fine.
  • A different size is not. A large needs its own recipe.
  • Eat in and takeaway: if one till item is eat-in and the other takeaway, the margin uses this recipe's VAT (see Dine-in vs to-go costing).

Brikly also checks your till and warns you when something looks different:

WarningWhat it means
Different prices: £3.30 and £4.10 (Latte). Is this a different size?The two till prices are more than 15% apart. Open prices are never compared.
One is charged VAT and the other isn't (Latte).Your till always charges VAT on one of them and never on the other.
This will make Latte's price come from this button instead.The recipe's selling price comes from one of its till items. Linking this one means the price will come from this till item from now on.

These are only warnings: you can still link the recipe. The link is saved the same way as any other.

While Brikly checks which till items the recipe is on, the picker says "Checking which till items this recipe is on..." and the link button waits until it knows. If the check fails, the picker says it couldn't check, so it can't warn you, and you can still link the recipe.

To link the same recipe to several variations of one till item at once, use the costing run.

Cost history from​

When you link a recipe to a POS item for the first time, the modal asks for a Cost history from date. This is the day Brikly starts attributing that item's sales to the recipe.

The default is usually the item's first sale, so your whole history for that item is costed at once.

There is one exception. If the item's name has changed several times in the last 90 days, it is probably a rotating slot - a soup of the day, a weekly special - and restating all of that history at one recipe would be wrong. In that case Brikly defaults to the first sale under its current name and tells you why:

This item has had 7 names in the last 90 days. History before 31 Aug 2026 was a different item.

You can change the date within the range Brikly allows - no earlier than the item's first sale (or, for an item that was linked before, normally the day after its earlier link started), and no later than today.

How the date is applied

The week and month containing the date you choose are attributed whole to the recipe. Earlier weeks and months are left uncosted rather than restated.

If a linked item is renamed in your POS later on, Brikly flags it for review rather than quietly carrying on - see Renamed POS items.

Linking from the recipe editor​

When you edit a recipe that is already linked to a till item, the recipe details say Linked to a Square item (or your till's name) and offer Open Item Mapper. Change the link or add another one there.

When you edit a saved recipe that is not linked yet, you can link a till item from the editor. Linking keeps the recipe's name and category. If the till item has a fixed price, saving makes it the recipe's selling price, and when the two differ the editor shows the till price it will use before you save. An item with an open price keeps the selling price on the recipe.

Archiving and restoring a linked recipe​

Archiving a recipe that is linked to till items pauses those links from tomorrow: sales up to today keep the recipe, and later sales of those items are not costed. The archive confirmation says so.

Restoring the recipe does not reopen the links. The restore message names the till items that were paused, so you can link them again here.

When your till is disconnected​

Disconnecting a till pauses its links rather than removing them (see Managing integrations). Brikly does not reopen them when you reconnect: link each item again here. For an item whose link the disconnect paused, Cost history from defaults to the day the link was paused, and the modal says "This item's link was paused when the till was disconnected. Costing picks up from that day, so no sales are missed."

Linking is refused while the till is disconnected, for example from a page left open from before the disconnect. Brikly says "Square is not connected. Connect it again in Settings > Integrations, then link the item." (with your till's name).

Multi-location support​

If you operate across multiple locations, the Item Mapper shows location availability for each item. Use the location filter to see which items are available at specific sites.