# Item

## Items are the third hierarchy and can hold modifiers and sizes 

![](/files/-LQd49H59GvbN82PFdWt)

## Item features

While hovering on an item there are 4 icons on the right:

* Edit - Enter the edit category screen
* Duplicate - Duplicate an item with all of it's contents.
* Delete - Deleting the category. **Cannot be undone**.
* 3 Lines / hamburger - Moving the item up and down to change the order of appearance on the app.

![](/files/-LQd4Z1-oW1zBHVfgEGS)

## Editing an item

After pressing on the pencil icon the Item editor opens:

### Item:

![](/files/-LQd6BY5L1B0V2x_a3Pz)

* Item Name -The name of the item that will be shown on the app.
* Description - Enter a description of the item.
* Metadata - Insert internal notes that would be shown only at the backoffice. We could use this feature if we have two items that have a slight difference between them for two locations. 

![](/files/-LQd8XDm9iwlX1XKuWnX)

* Unavailable In - Allows you to limit a certain item to be available only at certain locations.
* Item Type - Enter the item's type, Regular or Pizza (This will make the pizza toppings available for the pizza items). 
* Minimum Allowed Count - Allows you to set a minimum amount of the same items to purchase (Relevant only if grater then 1) 
* Size Category - Allows you to insert different prices and PLU's/Barcodes under the same item 

{% hint style="warning" %}
**This option is relevant if all items have the same modifier groups.** 
{% endhint %}

* Replace Image \ Upload Image - Click and choose the item's image from your computer (image must be under 400 KB).

### Price:

* Different size groups for items:

![](/files/-LQdBBYcnDyUUMKR45pH)

![](/files/-LQdBGDzGAF0Framwzwd)

{% hint style="warning" %}
Make sure to inset a price for each dining option and insert a PLU / Barcode 
{% endhint %}

![Click and insert PLU / Barcode](/files/-LQdBhNbSNnk51k-GIcj)

* Show Advanced Specific Menus - Allows you to set different prices for different menus.
*

### Ingredient:

{% hint style="info" %}
In order to activate the Ingredient option you'd have to go to Setup->Ingredients and insert a value under POS Link for "Without Item" (any value would do). 
{% endhint %}

Click Add ingredient and type the ingredient's name. 

* Mandatory - Click to make the ingredient mandatory. 
* Link - You would need to link the ingredient to the "No Ingredient" option in your POS. For example, if you add Tomato Sauce as an ingredient you would have to link it to the No Tomato Sauce PLU / Barcode in order for it to be printed as "No Tomato Sauce".

### Item Option:

Here we set the modifier groups for the item. We can build the groups in 2 ways:

-Create the group manually by adding each modifier separately in the Item.

* To create a new modifier group simply click "Add options group" and insert the name of the group and then insert the modifiers by clicking "Add option". 
* While hovering on an Option Group there are 8 options on the right:

  * Min - Minimum amount of modifiers that need to be chosen for the group. This is Relevant if the modifier group is set to be required in the POS.
  * Max Included- Limits the maximum amount of modifiers that can be chosen for the option group without an extra fee.
  * Max With Extra Fee - Sets the maximum amount of modifiers that can be chosen for the group. 
  * Extra Fee - Charges a set price for all the modifier in the group after the user passes the number of modifiers included (Max Included). This box is only relevant if all the modifiers are set to have the same price.
  * Enable multi select - enables the end user to select more than one of each modifier (eg. add 3 times additional banana to their shake). - see image below.
  * Parent - We can choose a parent group for the modifier group, this means that the group will be shown only if the user makes a selection for the modifier group that is set as the parent.
  * Template - This box connects the group to the group modifier group in the setup and allows you to make changes in the future easily.
  * Delete - Deleting the group. **Cannot be undone**.
  * 3 Lines / hamburger - Moving the group up and down to change the order of appearance on the app.

![](/files/-M84VyNq9YYv0UqHGkjk)

![Multi select enabled](/files/-M84WPFCDYoHJBWErZXc)

* Add a new modifier by clicking "Add option".
* While hovering over a modifier there are 6 icons on the right:
  * Price - Set the modifier's price. 
  * Gear icon- Allows you to set a different price between different menus and even make certain modifiers unavailable for certain menus. 
  * Default - Allows to make the modifier a default modifier.
  * Trash Icon - Delete Modifier.
  * Link icon - Connect the modifier to a PLU / Barcode.
  * 3 Lines / hamburger - Moving the modifier up and down to change the order of appearance on the app.

![](/files/-LQdNz1hJkRFGXJeMVPr)

#### Changing Modifiers Order

{% file src="/files/-LsWsqF3-tFR\_ubURbJO" %}
Changing Modifiers Order
{% endfile %}

Create the group at the Setup tab under Menu and choose the group for the item from a scroll down menu. 

To see how to create a modifier group in the Setup tab go to the Setup Tutorial:

{% content-ref url="/pages/-LQiDSlIF7P91XDu0Za4" %}
[Setup Tab](/portal/menu-editor/setup-tab.md)
{% endcontent-ref %}

## Toppings

#### This segment is relevant for pizza items only.

{% hint style="info" %}
In order to activate the Toppings option you'd have to go to Setup ->  Toppings and insert a value under POS Link for all portions (any value would do). 
{% endhint %}

{% hint style="info" %}
Also, insert what you would like the ticket to say : Full portion, Left Half and Right Half.

Last, do not forget to enter Pizza as the item's type.
{% endhint %}

Just like the modifier groups,  We can build the topping category in 2 ways:

-Create the group manually by adding each topping separately for the Item.

* To create a new topping category simply click "Add topping category" and insert the name of the category and then insert the toppings by clicking "Add topping". 
* While hovering on an topping category there are 6 options on the right:
  * Min - Minimum amount of toppings that need to be chosen for the group. This is Relevant if the topping category is set to be required in the POS.
  * Max Included- Limits the maximum amount of toppings that can be chosen for the option group without an extra fee.
  * Max With Extra Fee - Sets the maximum amount of toppings that can be chosen for the group. 
  * Extra Fee - Charges a set price for all the toppings in the group after the user passes the number of toppings included (Max Included). This box is only relevant if all the toppings are set to have the same price.
  * Delete - Deleting the category. **Cannot be undone**.
  * 3 Lines / hamburger - Moving the category up and down to change the order of appearance on the app.

![](/files/-LQdotI1gjWuog7iZufh)

* Add a new topping by clicking "Add topping".

* While hovering on a topping there are 4 options on the right:

  * Description - Enter a description to the topping.
  * Default - Allows to make the topping default.
  * Trash Icon - Delete topping.
  * 3 Lines / hamburger - Moving the topping up and down to change the order of appearance on the app.

* Under the topping you'd have to mark the portions you want as available.

* While hovering on a portion there are 3 options on the right:
  * Price - Set the portion's price
  * Gear icon- Allows you to set a different price between different menus and even make certain toppings unavailable for certain menus. 
  * Link icon - Connect the modifier to a PLU / Barcode.

![Hovering over a topping](/files/-LQdqYQrFKN9WKeMzSpc)

![Hovering over a portion](/files/-LQdqdKCZKvHkdIomo33)

-Create the group at the Setup tab under Menu and choose the group for the item from a scroll down menu. 

{% hint style="info" %}
To see how to create a modifier group in the Setup tab go to the Setup Tutorial. 
{% endhint %}

{% content-ref url="/pages/-LQiDSlIF7P91XDu0Za4" %}
[Setup Tab](/portal/menu-editor/setup-tab.md)
{% endcontent-ref %}


---

# 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/item.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.