> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofatoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Variations, Modifier Groups, and Item Modifiers

> Set up size and price variations, reusable modifier groups like Sauce and Toppings, and attach them to the right menu items so staff and customers can customize orders.

When the same dish comes in different sizes or with optional extras, you use three building blocks in the web admin: **variations** for size and price variants, **modifier groups** for reusable lists of options, and **item modifiers** to attach those groups to specific items. Together they let your team add a pizza as "Large with extra cheese" in a couple of taps on the POS or the ePOS app.

<Info>
  All three are configured in the browser dashboard under **Menu**. Once set up, they appear automatically when staff build an order on the POS or ePOS app, and on your customer ordering site.
</Info>

## How the pieces fit together

<Columns cols={3}>
  <Card title="Variations" icon="ruler">
    Size and price variants of a single item, such as Small, Medium, and Large at different prices.
  </Card>

  <Card title="Modifier groups" icon="list-checks">
    Reusable lists of options, such as Sauce or Toppings, each option with its own price and availability.
  </Card>

  <Card title="Item modifiers" icon="link">
    The link that attaches a modifier group to a particular item, optionally only for one variation.
  </Card>
</Columns>

A good rule of thumb: use a **variation** when the choice changes the base price of the item (a Large costs more than a Small), and a **modifier** when the choice adds optional extras or swaps (extra cheese, no onions, choice of sauce).

## Permissions

* Adding and editing **variations** on an item requires the same access as managing menu items (staff who can view and edit menu items).
* Working with **modifier groups** and **item modifiers** is available to staff who can view menu items.
* If you cannot see the **Modifier Groups** or **Item Modifiers** entries under Menu, ask an administrator to grant your role the menu item permissions. See [Roles and permission tiers](/staff/roles-and-tiers).

## Item variations

Variations are size and price variants that belong to one menu item. Each variation has a name and its own price, so "Pizza" can be sold as Small, Medium, or Large.

<Steps>
  <Step title="Open the item">
    Go to **Menu > Menu Items**, find the item, and open it. Variations are managed from the item itself.
  </Step>

  <Step title="Add a variation">
    Add a new variation, give it a name (for example, Small), and set its price.
  </Step>

  <Step title="Add the rest">
    Repeat for each size or variant you sell. You can edit a variation's name or price, or delete one, at any time.
  </Step>
</Steps>

<Tip>
  When an item has variations, the variation price is what gets charged for that size. Set up your sizes before attaching variation-specific modifiers, because you will choose which variation a modifier applies to.
</Tip>

For everything else about creating and editing the underlying item, see [Adding and editing menu items](/menu/menu-items).

## Modifier groups

A modifier group is a reusable list of options you can attach to many items. Typical groups are **Size**, **Sauce**, or **Toppings**, and each group holds the individual options customers can pick.

<Steps>
  <Step title="Create a group">
    Go to **Menu > Modifier Groups** and create a new group. Give it a clear name such as Toppings or Sauce.
  </Step>

  <Step title="Add options">
    Add each option inside the group. For every option set:

    * **Name** — what the option is called, for example Extra Cheese or BBQ Sauce.
    * **Price** — the extra amount this option adds. Leave it at zero for options that are free.
    * **Availability** — turn an option off when it is temporarily out of stock so it no longer appears when ordering.
  </Step>

  <Step title="Reuse across items">
    A single group can be attached to as many items as you like. Build it once and reuse it, rather than recreating the same options per item.
  </Step>
</Steps>

You can edit an option's price or availability, delete a single option, or delete the whole group. Use the search box to find a group or an option quickly.

<Warning>
  Deleting a modifier group removes it from every item it was attached to. If you only want to stop offering one choice, delete or turn off that single option instead of the entire group.
</Warning>

## Item modifiers: attaching groups to items

Modifier groups do nothing on their own until you attach them to items. **Item modifiers** are where you decide which items offer which groups.

<Steps>
  <Step title="Open Item Modifiers">
    Go to **Menu > Item Modifiers**. This page lists every modifier group attached across all your items.
  </Step>

  <Step title="Attach a group to an item">
    Add a modifier: choose the menu item, then choose the modifier group to attach to it. For example, attach Size and Crust to Pizza.
  </Step>

  <Step title="Limit to a variation (optional)">
    If a group should only apply to one size, link the modifier to a specific **variation** of the item. This is how a topping or option can appear for the Large pizza but not the Small.
  </Step>

  <Step title="Adjust later">
    You can edit which variation a modifier is linked to, or remove a modifier from an item, at any time. Search by item name or group name to find an attachment.
  </Step>
</Steps>

<Tip>
  Leave the variation field empty when a modifier should apply to the item no matter which size is chosen. Set a variation only when the options differ by size.
</Tip>

## How customers and staff see these choices

Once configured, variations and modifiers appear automatically wherever the item is ordered:

* **On the POS and ePOS app**, when staff tap an item that has variations, they pick the size first; any attached modifier groups then offer the relevant options (and any extra charges are added to the line).
* **On your customer ordering site**, the same choices appear so customers can build their own order.
* Options or sizes you turn off no longer appear until you make them available again.

<Note>
  Variation prices and modifier option prices flow straight into the order total and the kitchen ticket, so keep both accurate. Review them whenever your menu prices change.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Adding and editing menu items" icon="utensils" href="/menu/menu-items">
    Create the base items that variations and modifiers attach to.
  </Card>

  <Card title="Creating menus and item categories" icon="folder-tree" href="/menu/menus-and-categories">
    Organize items into menus and categories.
  </Card>

  <Card title="Sorting menu items and categories" icon="arrow-down-up" href="/menu/sorting-items">
    Control the order items appear in for staff and customers.
  </Card>

  <Card title="Creating orders on the POS" icon="receipt" href="/pos/creating-orders">
    See how variations and modifiers show up while taking an order.
  </Card>
</CardGroup>
