How to Create an Allergen Matrix for Your Food Website
An allergen matrix gives customers a complete view of allergens across your product range. Here is how to build and maintain one on your food website.
How to Create an Allergen Matrix for Your Food Website
An allergen matrix — sometimes called an allergen chart or allergen grid — is one of the most powerful tools a food business can add to its website. It gives customers a single, at-a-glance view of which allergens are present in every product you sell, reducing anxiety for allergy-affected shoppers and dramatically cutting the volume of allergen enquiries your team has to handle manually.
If you sell food online, building and maintaining an allergen matrix is not just good practice — in many jurisdictions it is a legal requirement to provide allergen information before purchase. Here is a complete guide to creating one that works.
What Is an Allergen Matrix?
An allergen matrix is a table that lists your products down one axis and the major allergens across the other. Each cell indicates whether that allergen is present (contains), possibly present (may contain / cross-contact risk), or absent (free from) for that product.
A well-designed matrix allows a customer with, say, a nut allergy and a dairy intolerance to scan your entire product range in seconds and immediately identify which products are safe for them to order. This is far more useful than reading through individual ingredient lists for every item.
Legal Requirements for Allergen Information Online
Before getting into the practicalities, it's worth being clear on the legal baseline:
UK (Natasha's Law and FIC): Businesses selling PPDS food or non-prepacked food online must provide allergen information before purchase is concluded.
EU (Regulation 1169/2011): Mandatory allergen information must be available before the purchase is concluded for food sold at a distance.
US (FALCPA): Packaged food labels must declare the nine major allergens. FDA guidance recommends pre-purchase disclosure for online sales.
An allergen matrix on your website helps satisfy these pre-purchase disclosure requirements, but it does not replace label requirements for physical products.
Step 1: Document Every Recipe Completely
Your allergen matrix is only as accurate as the data behind it. The first step is to ensure you have a complete and up-to-date ingredient list for every product, including:
- All primary ingredients
- All sub-ingredients within compound ingredients (e.g., the full ingredient list of a bought-in sauce, stock, or spice blend)
- Processing aids that may carry over into the final product
- Any shared equipment or production line risks
Work with your suppliers to get full allergen declarations for every ingredient you buy in. Many ingredient suppliers will provide allergen matrices for their own products — request these and keep them on file.
Step 2: Map Each Product Against the Allergens
With complete recipe data in hand, go through each product and mark:
- Contains — the allergen is a deliberate ingredient
- May contain — there is a risk of cross-contact in production
- Free from — the allergen is absent and cross-contact risk has been assessed and controlled
Be conservative with your "free from" declarations. If you produce a nut-free product on the same line as a nut-containing product and your cleaning procedure has not been validated to remove all traces, the product should carry a "may contain nuts" advisory, not a "nut-free" claim.
Step 3: Design Your Matrix
Keep the design simple and scannable:
- Use a standard table layout with products in rows and allergens in columns
- Use consistent symbols — a filled circle, a tick, or the word "Yes" for "contains"; a warning triangle or "MC" for "may contain"; a dash or empty cell for absent
- Consider colour coding — red for "contains", amber for "may contain", green or empty for absent
- Make the table responsive so it works on mobile screens
- Include a clear legend explaining your symbols
Accessibility matters too — ensure the matrix works for screen readers and doesn't rely solely on colour to convey information.
Step 4: Keep It Updated
An allergen matrix is a living document. Every time you:
- Add a new product
- Change a recipe
- Switch a supplier
- Introduce new equipment or change production processes
...you must update the matrix. A stale allergen matrix is potentially worse than none at all, because customers may rely on it to make decisions about their safety.
Step 5: Link It Prominently
Your allergen matrix should be easy to find. Link to it from:
- Your website navigation or footer
- Each product page
- Your checkout page
- Your FAQ or help section
- Any allergen-related policies or pages
Don't bury it in a PDF that customers have to download. A live, searchable web-based matrix is far more useful and far more likely to be seen.
How to Handle Seasonal and Limited-Edition Products
Seasonal and limited-edition products create a particular challenge for allergen matrix maintenance because they appear and disappear from your range on a rolling basis. The temptation is to leave an old seasonal product on the matrix indefinitely, or to add a new one in a hurry without completing the full allergen mapping process first. Both approaches introduce risk. Every product, regardless of how briefly it appears in your range, must go through exactly the same allergen documentation process as your core lines before it goes on sale.
The most practical approach is to build a pre-launch checklist that includes allergen matrix update as a mandatory step before any new product becomes purchasable on your store. If you are using a tool like Allergen Matrix, adding a seasonal product to your matrix takes only minutes once your recipe data is documented — there is no excuse for launching a product without its allergen information being live and accurate. Treat the matrix update as part of the product setup workflow, not an afterthought.
When a seasonal product is retired, archive it rather than simply deleting it. Customers who purchased it previously may return to check allergen information for future reference, and having a record of the allergen data you published at the time can also be valuable if you ever need to demonstrate compliance. A clean archiving process keeps your live matrix tidy while preserving a complete historical record.
How to Communicate Cross-Contact Risks Clearly
Cross-contact — the unintentional transfer of an allergen from one food to another through shared equipment, surfaces, or handling — is one of the most misunderstood aspects of allergen communication for online food businesses. Many small producers operate in shared kitchens or use equipment that handles multiple allergens throughout the day. Customers with severe allergies need to understand not just what is in your products, but what your production environment looks like, so they can make an informed judgement about whether your products are suitable for them.
Your allergen matrix should reflect your actual production reality, but it is also worth adding a short narrative description of your production environment somewhere on your website — ideally on the same page as your matrix or linked directly from it. Describe the allergens present in your kitchen, what equipment is shared, and what cleaning procedures you follow between production runs. This level of transparency builds significant trust with allergy-affected customers and demonstrates that you take their safety seriously rather than treating allergen compliance as a box-ticking exercise.
If you have genuinely invested in segregated production areas or dedicated allergen-free equipment for specific product lines, say so clearly and explain what that means in practice. Customers who need, for example, a genuinely gluten-free product will be looking for exactly this kind of specific, credible assurance. Vague language like "we take allergens seriously" carries far less weight than a concrete description of your actual controls.
Using Technology to Automate Your Allergen Matrix
Maintaining a manual allergen matrix in a spreadsheet or a static web page quickly becomes unmanageable as your product range grows. Every recipe change requires a manual update, and the risk of errors — and therefore the risk to your customers — grows with complexity.
Allergen Matrix, our Shopify app for food businesses, automates this process. You enter your recipe data once, map your ingredients to the 14 major allergens, and the app generates and displays a live allergen matrix on your Shopify store. When you update a recipe or add a product, the matrix updates automatically. Your customers always see accurate, up-to-date allergen information before they buy.
The app also surfaces allergen warnings at the product level — so even if a customer never visits your main matrix page, they see the relevant allergen information on each product page.
Training Your Team on Allergen Matrix Accuracy
An allergen matrix is only as trustworthy as the team responsible for maintaining it. Even with the best tools in place, human processes determine whether the data behind your matrix stays accurate over time. Anyone involved in recipe development, ingredient procurement, or product setup on your online store needs to understand their role in the allergen data chain. A single undocumented ingredient substitution — swapping one brand of stock for another that contains celery, for example — can silently introduce an allergen that your matrix does not declare.
Build clear internal procedures that require allergen checks at every point where a recipe or ingredient can change. This means procurement staff flagging any supplier changes to whoever owns your allergen documentation, and product developers completing an allergen review before any recipe modification goes into production. These do not need to be complex processes — a simple shared checklist or a sign-off step in your recipe management workflow is often enough to catch the errors that lead to inaccurate allergen information reaching customers.
It is also worth designating a specific owner for your allergen matrix — someone whose responsibility it is to review the whole matrix on a scheduled basis, not just when changes are flagged. A quarterly review of every product against current supplier allergen declarations gives you a structured opportunity to catch any drift between your documented data and your actual ingredients, and demonstrates a proactive approach to allergen management that stands up well to regulatory scrutiny.
What About Precautionary Allergen Labelling?
Precautionary allergen labelling (PAL) — "may contain" statements — should appear on your matrix where a genuine cross-contact risk has been assessed. Do not use PAL as a blanket disclaimer to avoid the work of proper allergen control. Overuse of "may contain" statements renders them meaningless to allergic consumers and may exclude them from products that are actually safe for them.
Conversely, do not omit PAL where a genuine risk exists just to make your products look more allergy-friendly. Accurate and honest PAL is what keeps customers safe.
Summary
An allergen matrix is one of the highest-value additions you can make to your food website — it builds trust with allergy-affected customers, reduces enquiry volume, and helps satisfy pre-purchase allergen disclosure requirements. The key is accuracy, currency, and accessibility.
Try Allergen Matrix free at saltai.app — no credit card required.
SaltAI Team
SaltAI builds focused Shopify apps for food merchants and general merchants. Every app is tested in production at a real food store — including Vanda's Kitchen — before it ships.