Allergen matrix
The Allergen matrix is the consolidated, EHO-facing view of every menu item your business serves and the regulated allergens each one contains. It is the digital replacement for the printed allergen sheet most operators keep behind the counter as part of their SFBB (Safer Food Better Business) pack.
You will find it at /safety/allergens. The same matrix is shown to staff and guests on the kiosk tablet at each site: see Allergens on the kiosk.
Allergen declarations are made in CostingBrik. Each ingredient's allergens combine the declarations of every supplier SKU you buy it under, or come from the ingredient itself when it has no supplier (tap water, ice, bay leaves). The matrix in SafetyBrik is the consolidated reporting and audit view of those declarations, plus any manual menu items you add that are not in CostingBrik (drinks, third-party cakes, off-menu specials), and any add-ons on your till that have no recipe yet.
Read the data model first: CostingBrik allergens overview.
Why the matrix lives in SafetyBrik
CostingBrik is where the allergen data is managed. The matrix lives in SafetyBrik because that is where its three audiences look for it:
- The EHO - on a routine inspection they will ask "show me your allergen information". The matrix is what you hand them.
- The customer - the matrix is the source of truth for the customer information pack and any printed or in-app allergen statement.
- Your staff - new starters and existing team members use it as a quick reference when a guest asks about allergens.
CostingBrik is the data plane. SafetyBrik is the audit and presentation plane.
What the matrix shows
The matrix is a grid: one row per menu item, one column per regulated allergen.
The grid is built from these sources, merged automatically:
- Synced recipes from CostingBrik, tagged Synced. Their allergens come from the recipe allergen roll-up, built from each ingredient's declarations: every supplier SKU you buy it under, or the ingredient's own when it has no supplier.
- Manual menu items added directly in SafetyBrik, tagged Manual. Useful for anything you do not cost in CostingBrik (bottled drinks, third-party cakes, daily specials).
- Add-ons from your till with no recipe, tagged No recipe. Their allergens are not recorded anywhere, so they always show as not fully known. See Add-ons with no recipe.
A recipe with a variation is named Name (Variation), for example "Toasted Teacake (No Butter)", because two variations of one product can carry different allergens. The same name is used in search, in the details window, on the kiosk and in the PDF.
Add-ons and swaps
If you sell through a connected till, its add-ons and swaps (an oat milk swap, a flavoured syrup) appear in a separate Add-ons and swaps section below the menu items. They are named as your till names them, and sorting works within each section. An add-on or swap with its own recipe in CostingBrik shows that recipe's allergens, like any synced recipe.
Removals such as "No cheese" are not listed. A till option that takes something away but has not been set up as a removal in the Modifier Mapper, such as "No sauce", can show up as an add-on with no recipe. Mark it as not needing a recipe, as described below.
Add-ons with no recipe
An add-on with no recipe in CostingBrik, such as a caramel syrup or "Add butter", can still put an allergen on the plate, so the matrix lists it rather than leaving it out:
- It carries a No recipe tag and the Not fully known badge, and every allergen cell shows an amber
?. - It appears once per name. If "Caramel Syrup" is on three of your till's modifier lists, the matrix shows one "Caramel Syrup" row. Names are matched without regard to capital letters. If an add-on with that name already has a recipe, the ones without a recipe are not listed again.
- It is shown for every site.
- It is left out under the No ingredients containing filter.
Clicking the row opens its details, which say "This add-on has no recipe in CostingBrik, so its allergens are not recorded. Ask the kitchen." There is no ingredient breakdown. The Link a recipe, or mark it as not needing one link in the window, the Not fully known badge and the link icon at the end of the row all open the add-on's page in the Modifier Mapper. There you can:
- Build its recipe. The row then shows the recipe's allergens like any other add-on, normally within a minute.
- Mark it as not needing a recipe. Click Skip: no recipe needed for an option that adds nothing to eat or drink, such as "Extra hot", "Gift bag" or a grind size. The row leaves the matrix straight away. When you arrive from the matrix, the box to also mark the other modifiers with the same name is already ticked, so one click clears the whole row.
Only skip an add-on that adds no ingredients. A syrup marked as not needing a recipe leaves the matrix, so staff and guests would no longer see it. Build its recipe instead.
Reading a row
Above the grid, a key says what each mark means: an amber dot for contains, a dash for not declared in its ingredients and an amber ? for not known yet. Under it, every allergen's icon is listed with its name. The column headings are icons only, so the names are spelled out here for anyone reading on a tablet, where there is no hover. On a computer, hovering over a column's icon also shows its name.
Each cell tells you one of four things:
- An amber dot - the item contains this allergen, because a declared ingredient contains it. Hovering over it says, for example, "Contains Milk".
- A dash - not declared in its ingredients: none of the item's declared ingredients contain this allergen. This is not a free-from claim: allergens handled elsewhere in your kitchen are not covered (see the cross-contact caveat).
- An amber
?- not known yet. The row also carries a Not fully known badge. The item's allergens are not fully recorded, so any allergen it is not known to contain could still be there. - A spinner - the row reads Recomputing... while the recipe's allergens are worked out again after a recent change. This normally takes a few seconds.
A recipe is not fully known when:
- any ingredient anywhere in the recipe, sub-recipes included, has no allergen declaration (on every supplier SKU you buy it under, or on the ingredient itself when it has no supplier);
- an ingredient's allergen record has not yet caught up with what its SKUs declare; or
- the recipe has no ingredients yet.
An add-on with no recipe is always not fully known. So is a manual item with nothing ticked that was never confirmed as containing none (see Adding a manual item).
Amber dots still show on a not-fully-known row, because what is known to be there is still worth seeing. Click the Not fully known badge to open the recipe's Allergens tab in CostingBrik and review what is missing. On an add-on with no recipe, the badge opens the Modifier Mapper instead. On a manual item, the badge is not a link: click Edit on the row to record its allergens.
The details window
Click a row to open its details. They lead with Contains, because staff are usually asked by allergen ("can I have it without gluten?"). For a recipe it has one line per allergen, named in words, with the ingredients (or sub-recipes) that bring it, for example "Milk: Butter, Pesto (sub-recipe)". For a manual item, and for a moment while a recipe's ingredients load, the allergens show as named amber chips instead.
Below that, the Ingredient breakdown lists each ingredient (or sub-recipe) with the allergens it brings, each named in words beside its icon. An ingredient with no allergens declared reads "– No allergens declared", and one not yet reviewed reads "? Not known yet".
For a recipe whose allergens are not fully known, the window says Allergens not fully known. Ask the kitchen. and names the ingredients that still need review, for example "Not yet reviewed for allergens: Eggs, Pine nuts (in Pesto)." When some allergens are declared, it adds that others may also be present.
In the breakdown, each unreviewed ingredient is marked Not reviewed with a Declare allergens link, which opens the ingredient in CostingBrik at its allergen step. A sub-recipe row lists the ingredients inside it that still need review. Add-ons carry an Add-on or swap tag, and Open in CostingBrik takes you to the recipe's Allergens tab.
For a manual item, the window shows the allergens entered for it. If none are ticked:
- and the item was confirmed as containing none, it says "The business confirmed this item contains none of the 14 allergens.";
- otherwise it shows the amber notice and "No allergens are recorded for this item. Edit it to tick the allergens it contains, or confirm it contains none."
For an add-on with no recipe, see Add-ons with no recipe.
The cross-contact caveat
Under the filters, the matrix always shows:
Based on the allergens declared for each recipe's ingredients. Other allergens are handled in our kitchen, so cross-contact is possible. Please ask a member of staff if you have a severe allergy.
The matrix records which allergens your ingredients contain. It does not know how your kitchen controls cross-contact, so it is never a free-from answer for a guest with a severe allergy.
If recipes can't load
If SafetyBrik cannot load your recipes from CostingBrik, an amber banner reads "Couldn't load recipes, so this list may be incomplete. Only items added here are shown." with a Try again button. Export PDF is turned off until the recipes load, so you never print an incomplete matrix.
Filtering and searching
Above the grid you can:
- Search by item name, including the variation.
- Filter by location (businesses with several sites) - All sites, or one site, useful when one site serves a different menu. A site's view includes recipes set to all sites and recipes assigned to that site in CostingBrik.
- Filter by category - drawn from the categories on the items themselves.
- No ingredients containing - pick one or more allergens to show only items with no declared ingredient containing them.
While the No ingredients containing filter is on, items whose allergens are not fully known are left out, and a note under the filters says so. That includes add-ons with no recipe and manual items with no allergens recorded. An item is only listed when every ingredient has been reviewed. The cross-contact caveat still applies, so treat the result as a starting point for a conversation with the guest, not a guarantee.
Adding a manual item
For items that do not have a CostingBrik recipe, click Add item to open the manual menu item modal:
- Name and category.
- Which of the regulated allergens it contains. Tick each one, or tick Contains none of the 14 allergens if it has none. Ticking an allergen clears "contains none", and the other way round.
- Location scope - all locations, or specific sites.
Save stays off until you have ticked an allergen or confirmed the item contains none. Hover over it and it says "Tick the allergens this item contains, or confirm it contains none." Leaving every box empty is not the same as confirming none, so Brikly will not save an item that way. If the allergen list fails to load, the modal says "We couldn't load the list of allergens, so this item can't be saved yet. Close this window and try again."
An item you confirmed as containing none shows a dash in every cell. A manual item with nothing ticked and no confirmation, for example one added before the confirmation existed, shows as not fully known: ? in its cells, left out under the No ingredients containing filter, the amber treatment on the kiosk, and ? in the PDF. Click Edit on its row, tick its allergens or confirm it contains none, and save.
Manual items show up in the matrix alongside synced recipes and behave identically in the export. Adding, changing and archiving a manual item, with its allergens before and after a change, is recorded in the Audit log.
Duplicates and Promote
When a manual item has the same name as a synced recipe, it gets a Duplicate tag and a Promote button. Promote archives the manual item and keeps the synced recipe, so its allergens come from CostingBrik from then on. The audit log records it as Menu item archived, naming the recipe that replaced it.
Names are matched with the variation, so a manual item called "Toasted Teacake (No Butter)" matches that variation. A name without a variation only matches when exactly one menu recipe has it, and add-ons are never matched. If nothing matches, Brikly tells you to include the variation in brackets.
Editing in CostingBrik: the round-trip
For a row that came from CostingBrik, the Edit in CostingBrik action deep-links straight to that recipe's Allergens tab:
/costing/recipes/{recipe-id}?tab=allergens
This is the workflow:
- Spot a row in the matrix that needs review.
- Click Edit in CostingBrik - you land on the recipe's Allergens tab.
- See the per-source breakdown showing which ingredient (or sub-recipe) contributed each allergen, and which ingredients still need review.
- Update the declaration if needed, on the supplier or on the ingredient (in CostingBrik's declaring allergens flow).
- Save. The recipes that use the ingredient show as recomputing for a moment, normally a few seconds, and then the matrix, the kiosk and the PDF show the change.
On an add-on with no recipe, the link icon at the end of the row goes to the add-on's page in the Modifier Mapper instead. See Add-ons with no recipe.
This round-trip is intentional. Declarations belong with the supplier and ingredient data they are derived from (CostingBrik). The matrix view belongs with the audit and reporting surface (SafetyBrik). Each side does what it is best at.
Exporting for an EHO visit
Click Export PDF to download a dated allergen matrix PDF, titled "Allergen matrix: " followed by your business name. This is the document you keep printed in your SFBB folder and hand to the EHO on request.
A few behaviours worth knowing:
- The PDF is always built from fresh data, never from a copy saved earlier.
- Its heading names the site you filtered to, or reads "Location: All sites", and says when it was made, in your local time, for example "Generated: 9 Oct 2026 14:05 BST". The downloaded file is named with the day on your device, for example "allergen-matrix-2026-10-09.pdf".
- Names with accents, and Greek or Cyrillic letters, print as typed.
- The cells use the same marks as the screen: an amber dot where the item contains the allergen, a dash where it is not declared in its ingredients, and an amber
?where it is not known yet. No cell is left blank. The key ("Key: ● contains · – not declared in its ingredients · ? not known yet") prints at the foot of every page, so a single page pinned up on its own still explains itself. - Variations print as Name (Variation), and add-ons and swaps print in their own Add-ons and swaps table. Long names and categories wrap rather than running into the next column.
- An item whose allergens are not fully known (a recipe with unreviewed ingredients, an add-on with no recipe, or a manual item with no allergens recorded) prints
?in every cell it is not known to contain and a*after its name. A footnote explains: "* Allergens not fully known. These items have ingredients not yet reviewed for allergens, or no allergen record, so cells marked ? are unknown, not confirmed absent. Ask the kitchen." When any item is in this state, hovering over Export PDF says "Some items' allergens are not fully known. Their unknown allergens print as "?" in the PDF." - Every PDF ends with the cross-contact caveat.
- While any recipe is recomputing, the export waits. Export PDF is turned off for a moment ("Recomputing. Try again shortly."), and if a change lands just as you export, you see a Recomputing in progress message. Try again in a few seconds.
- If your recipes cannot be loaded, the export is refused with "We couldn't load your recipes, so the PDF would be incomplete. Try again in a moment." The Export PDF button is turned off while the recipes-could-not-load banner is showing.
Cross-references
- Allergens on the kiosk - the same matrix on the shared tablet at each site.
- CostingBrik: allergens overview - the full data model and how declarations are made.
- CostingBrik: declaring allergens - how to record declarations on a supplier, or on an ingredient with no supplier.
- CostingBrik: recipe allergen roll-up - how the per-recipe allergen profile is calculated.
- Modifier Mapper - where an add-on from your till gets a recipe, or is marked as not needing one.
Region availability
The matrix currently supports the 14 UK-regulated allergens. For non-UK tenants, SafetyBrik shows a "coming soon" panel until the regulated allergen registry for that region is enabled.