> 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/settings/allergen-settings.md).

# Allergens & diet tag settings

FoodCore tracks the 14 declarable allergens across all your ingredients and recipes out of the box. But every kitchen is different — the tags and terms that make sense for a large allergen-aware café are different from those needed by a specialist gluten-free bakery. Allergen & Diet Tag Settings let you tailor how allergens and dietary tags behave across FoodCore to match your actual menu and workflow.

## What you can customise

### Show or hide diet tags

FoodCore includes a default set of diet tags: Vegan, Vegetarian, Gluten-Free, Dairy-Free, Nut-Free, and others. If certain tags are irrelevant to your menu — for example, you only produce gluten-free products so a "Gluten-Free" tag adds no meaningful information — you can hide them. Hidden tags disappear from forms, recipe views, and label options across the whole account.

To hide a tag: **Settings → Allergens → Diet Tags → toggle the tag off**.

### Reorder diet tags

The order diet tags appear in forms, recipe pages, and label options is controlled here. Drag tags into the order that matches your priorities. If gluten-free is the most important claim for your customers, put it first so your team sees it at the top of every form.

To reorder: **Settings → Allergens → Diet Tags → drag to reorder**.

### Add custom diet tags

If your menu uses tags that aren't in FoodCore's default list — for example, "Keto-Friendly", "Low-FODMAP", or a brand-specific diet programme — you can add your own custom tags. Custom tags behave identically to built-in tags: they appear in forms, recipes, and label options.

To add a custom tag: **Settings → Allergens → Diet Tags → + Add Custom Tag → enter the tag name → Save**.

### Manage phrase exclusions

Phrase exclusions are one of the most powerful and underused features in FoodCore's allergen settings. Here's the problem they solve: FoodCore scans ingredient names and descriptions to flag potential allergens. This works brilliantly most of the time, but it can produce false positives.

For example, "coconut butter" contains the word "coconut" — and coconut can be classified as a tree nut in some allergen frameworks. If your coconut butter supplier processes it in a completely nut-free facility and you've verified it carries no tree nut risk, you don't want FoodCore flagging every recipe that uses it. A phrase exclusion tells FoodCore: "when you see this phrase, don't trigger that allergen."

Phrase exclusions are specific and intentional. They're not a way to suppress allergen warnings across the board — they're a way to tell FoodCore about the specific products in your kitchen that you've already assessed and confirmed are safe.

**To add a phrase exclusion:**

**1. Go to Settings → Allergens → Phrase Exclusions**

**2. Click + Add Exclusion**

**3. Enter the phrase** — use the exact term as it appears in your ingredient records. Matching is case-insensitive, so you don't need to worry about capitalisation.

**4. Select the allergen** the exclusion applies to. The exclusion is specific to one allergen — so "coconut butter" excluding tree nuts won't affect any other allergen detection for that ingredient.

**5. Click Save**

The exclusion takes effect immediately across all recipes and ingredient checks that reference that phrase.

{% hint style="warning" %}
FoodCore helps you organise and manage the information you need, but you should always check official guidance or speak to your local authority if unsure.
{% endhint %}

## A note on exclusion responsibility

Adding a phrase exclusion is a manual decision that overrides FoodCore's automatic allergen detection for that specific term. Before adding an exclusion, make sure you've:

* Checked the supplier's allergen information and specifications
* Confirmed the product is manufactured in a way that eliminates the relevant risk
* Documented your reasoning (keeping a note of your supplier's allergen declaration is good practice)

Phrase exclusions are powerful, but they should reflect a real, verified absence of risk — not a shortcut to suppress an inconvenient warning.

## What's next

* [Add allergens to an ingredient](https://docs.foodcore.io/allergens/add-allergens.md)
* [Allergen audit](https://docs.foodcore.io/allergens/audit.md)
* [Settings overview](https://docs.foodcore.io/settings/settings.md)
