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

# Modifiers

> Let customers customise storekit products with modifier groups. Configure options, min/max selections, free choices, pricing, and required vs optional.

Modifiers let customers customise products. They're organised into **modifier groups** - each group contains options and rules about how many can be selected.

## Examples

| Modifier Group   | Options                         | Rules                    |
| ---------------- | ------------------------------- | ------------------------ |
| Choose your size | Small, Medium, Large            | Required, pick exactly 1 |
| Add toppings     | Pepperoni, Mushrooms, Olives... | Optional, pick up to 5   |
| Select your base | White rice, Brown rice, Noodles | Required, pick 1         |
| Extra sauces     | Ketchup, Mayo, BBQ...           | Optional, pick any       |

## Creating a Modifier Group

1. Click on a product to open the editor
2. Go to the **Modifiers** tab
3. Click **Add Modifier Group**
4. Enter a name (e.g., "Choose your size")
5. Add options with names and prices
6. Set min/max selection rules
7. Click **Save Modifiers**

## Modifier Group Settings

### Name & Description

| Field           | Description                                   |
| --------------- | --------------------------------------------- |
| **Name**        | Shown to customers (e.g., "Choose your size") |
| **Description** | Optional extra context                        |
| **SKU / PLU**   | For POS integration                           |

### Selection Rules

Set how many options customers must/can choose:

| Setting         | Example         | Behaviour                  |
| --------------- | --------------- | -------------------------- |
| Min: 1, Max: 1  | Choose a size   | Required, pick exactly one |
| Min: 0, Max: 3  | Add toppings    | Optional, pick up to 3     |
| Min: 2, Max: 4  | Pick your sides | Required, pick 2-4         |
| Min: 0, Max: 10 | Extra sauces    | Optional, pick any number  |

<Tip>
  Set **Min: 0** to make a modifier group optional. Set **Min: 1** or higher to make it required.
</Tip>

### Allow Multiple of Same Option

Enable **Allow customers to select an option more than once** for cases like:

* "2x extra cheese"
* "3x bacon"

You can optionally set a specific limit per option.

### Free Modifiers

Set a number of **Free Modifiers** to give customers a certain number of free selections before charging. Useful for:

* "First 3 toppings free, then £0.50 each"
* "Includes 2 sauces, extra sauces £0.30"

## Modifier Options

Each option within a group has:

| Field              | Description                      |
| ------------------ | -------------------------------- |
| **Name**           | Option name shown to customers   |
| **Price**          | Additional cost (can be £0)      |
| **Original Price** | For showing discounts on options |
| **POS ID**         | For POS integration              |
| **Tax Rate**       | Override default tax             |
| **Default Qty**    | Pre-select this option           |
| **In Stock**       | Toggle availability              |

### Default Quantity

Pre-select options by setting a default quantity. The total of all default quantities cannot exceed the group's maximum.

### Option Availability

Toggle **In Stock** off to temporarily hide an option without deleting it.

### Tags & Allergens

Modifier options can have their own allergen information, dietary tags, and nutrition data. When a customer selects options, the combined allergen information from the product and all selected modifiers is shown.

See [Tags & Allergens](/docs/guides/menu/tags-allergens) for details.

## Display Settings

### Initial Display Setting

Control how the modifier group appears on the product page:

| Setting       | Behaviour                             |
| ------------- | ------------------------------------- |
| **Expanded**  | Options visible immediately (default) |
| **Collapsed** | Options hidden behind a tap/click     |

### Print as Products

Enable **Print modifier options as products** to print each selected modifier on its own line on receipts, rather than as sub-items under the product.

## Reusing Modifier Groups

You can attach existing modifier groups to multiple products:

1. Open a product's Modifiers tab
2. Click **Add Existing Group**
3. Select from your existing modifier groups

Changes to a shared modifier group affect all products using it.

<Warning>
  Editing a shared modifier group updates it everywhere it's used. Create a new group if you need different options for specific products.
</Warning>

## Reordering

* Drag modifier groups to change their order on the product
* Drag options within a group to change their order

## Deleting Modifier Groups

1. Open the modifier group
2. Click **Remove Group**

This removes the group from the current product. If it's shared with other products, it remains on those products.

## Tips

* **Name groups clearly** - "Choose your size" not "Size options"
* **Order options logically** - Smallest to largest, or most popular first
* **Use £0 options** - For substitutions or preferences (e.g., "No onions")
* **Set sensible limits** - Too many options overwhelms customers
* **Use free modifiers** - Encourages customisation without complexity


## Related topics

- [Menu Overview](/docs/guides/menu/overview.md)
- [Menu Structure](/docs/guides/menu-engineering/menu-structure.md)
- [Nested Modifiers](/docs/guides/menu/nested-modifiers.md)
- [Removal Modifiers](/docs/guides/menu/removal-modifiers.md)
- [Free Modifiers](/docs/guides/menu/free-modifiers.md)