# Allergens

## Overview

In this guide, we will learn how to configure allergens for your business and how to add them to a menu item. Allergens can be configured and view on the menu item level, and will be prestented next to each item.

{% hint style="info" %}
IMPORTANT - Appfront Do not take any responsibility for any issue thay might come up with your customers.&#x20;
{% endhint %}

## Customer Facing Preview

Once you set up the Allergens on Appfront portal, the customer will see that in a few places on the platform.

### Allergens Button

A new button will appeard with a break down of all the Allergens you will add to the platform \
(see on top right - new Allergens button).

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LepM360ux8vCFvBcwZO%2F-LepOfr6L3kdoLDKlnb3%2FScreen%20Shot%202019-05-14%20at%2011.12.25%20AM.png?alt=media\&token=073baa2a-2dfe-4ddf-ad37-33ceb3271a0e)

### Allergens Menu

Once you click on this button, a pop up with all alleregens icon and desciption will be appear to the customer. Icons and descriptions it's something that you add by yourself on Appfront portal.

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LepM360ux8vCFvBcwZO%2F-LepPDsmlu9qkctjWwXl%2FScreen%20Shot%202019-05-14%20at%2011.14.58%20AM.png?alt=media\&token=1249b98f-ca1a-4247-85ed-9c7a8a392d29)

### Menu Item Level Allergens Description

Next to each menu item, a new icon will appear, based on the setting.&#x20;

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LepPszv3HhAvEtssRrU%2F-LepQIVvxmcvab5jaexT%2FScreen%20Shot%202019-05-14%20at%2011.19.43%20AM.png?alt=media\&token=cf9d3468-3774-4d86-a693-2107183f8fe7)

## How to Set Up Allergens

### Configuring Allergens

First, go to the portal and sign in. Click Configure --> Menu --> Allergens (circled in red): ![](blob:https://app.gitbook.com/f4e7c0b5-b29f-4393-ae79-125577ff732e)<br>

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LczBygNYK0m2tC6iWh6%2F-LczCBKHVvDLFARmf46R%2FScreen%20Shot%202019-04-21%20at%2012.06.26.png?alt=media\&token=dfad09c5-af21-49a0-a522-268223827990)

This is where you configure allergens for your business. They are general and will be available to configure for every menu item.

In order to create a new allergen, you will need to give it a title and a description (optional).&#x20;

The title will be used to describe the allergen icon to the user in the allergens info list in the app. Further description is optional.

The tag is something **unique** for each allergen and can be used to substitute the icon in textual names within the modifiers and toppings - once you set a tag you **cannot** change it, so think about a good tag to describe the allergen. A tag has to be wrapped in \[ ].  In order to add the icon to a modifier name - you can define an allergen of Gluten Free with the tag: \[GF] and change the "Gluten Free" modifier to : "Gluten Free \[GF]" and this will result in the following presentation:

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LqobBrlRdmQghwK9Quh%2F-LqobDbUb_hFODfXHwu_%2Fimage.png?alt=media\&token=947c95dc-90e4-43dc-8cec-a6362fb1af3f)

In the image category, you will need to upload an SVG file for the allergen.

Next, click on save and you can see your allergen added to the list:![](blob:https://app.gitbook.com/6f2ff230-8736-426d-bc8a-27b18a166d0e)<br>

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LczBygNYK0m2tC6iWh6%2F-LczCMmuiI33XOYM0K3O%2FScreen%20Shot%202019-04-21%20at%2012.17.06.png?alt=media\&token=c4d4d64a-782d-4dc0-a43c-2c748fa12680)

Here you can see an example of a gluten free allergen that was added.

### Adding an Allergen to Menu Item

Now that we've added an allergen to our list, we will review how to add them to the actual menu item. So first we need to go to our menu (App Menu tab on current page). We will choose our item from the categories and click edit.

You will see now, an allergens category on the menu item. When clicking on it, a list opens up of all the allergens that we just configured. You can choose the allergens that are applicable for this menu item, add them and click save.

![](https://3305729690-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LMC9-95h4Q1CvHx7JAZ%2F-LczCYDfj4UQMaKDJG42%2F-LczEJPFzUgxiQ03Q9ey%2FScreen%20Shot%202019-04-21%20at%2012.31.01.png?alt=media\&token=207751ce-e8d2-4a1e-87cd-da352f7c7fd0)

Congratulations! You've learned how to add and configure allergens for your business, you should be able to see the change in about 15 - 30 min.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://appfront.gitbook.io/portal/menu-editor/allergens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
