> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/allergens/matrix.md).

# The allergen matrix

The allergen matrix is your whole-menu allergen overview in a single screen. It's a grid with every recipe listed down the left-hand side and all 14 declarable allergens across the top. At a glance you can see exactly which products contain or may contain each allergen — without having to open individual recipes one by one.

It's the kind of document a food safety inspector will ask to see, and it's also exactly what your front-of-house staff need when a customer asks, "Can I eat this if I have a nut allergy?"

## How to Find the Matrix

**Go to** **Allergens** in the main navigation, then **click** the **Matrix** tab.

The matrix loads automatically based on your current ingredient allergen data. There's no manual refresh needed — it always reflects the most recent allergen settings across all your ingredients.

## Reading the Matrix

Each cell in the grid represents the relationship between one recipe and one allergen. The symbols mean:

* **✓** — the allergen is **present** in this recipe (at least one ingredient is marked as Contains)
* **M** — the allergen **may be present** due to cross-contamination risk (at least one ingredient is marked as May Contain, and none are marked as Contains)
* **✕** — the allergen is **not present** and there is no known cross-contamination risk

If a recipe has incomplete allergen data — for example, an ingredient that hasn't had its allergens set yet — the cell will be flagged differently to indicate uncertainty. This is a prompt to run the allergen audit and fill in the gaps.

## Filter the Matrix

You don't always need to see everything at once. FoodCore lets you filter the matrix in two ways:

* **Filter by recipe category** — if you have your recipes grouped by type (e.g. breads, cakes, savoury), you can narrow the matrix to just one category to make it easier to read and print
* **Filter by allergen** — focus on one or more specific allergens to quickly identify all products that contain or may contain them. This is useful when a customer asks about a specific allergy, or when you're updating your menu for a particular dietary need

**Click** the filter controls above the matrix to apply your selections. The grid updates immediately.

## Export the Matrix

You can export the allergen matrix in two formats:

* **CSV** — opens in Excel or Google Sheets. Useful if you want to edit the layout, incorporate it into another document, or share it with your environmental health officer as a raw data file
* **PDF** — a print-ready version formatted for A4. Good for posting in your kitchen, handing to staff, or including in your food safety folder

**Click** the **Export** button at the top right of the matrix view and choose your format.

## Keep the Matrix Current

The matrix is only as accurate as your underlying allergen data. The two main ways it can become outdated are:

1. **A new ingredient is added** but its allergens haven't been set yet
2. **A supplier changes their product** and you haven't updated the ingredient record

Make it a habit to run the **allergen audit** after any changes to your ingredients or recipes, especially after onboarding a new supplier or swapping out an ingredient. The audit will flag any recipes where allergen data is incomplete, so you can fix them before they affect a label or a customer query.

## What's Next

* [Run the allergen audit](https://docs.foodcore.io/allergens/audit.md)
* [Plan menus around allergen requirements](https://docs.foodcore.io/menus-core/menus.md)
