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

# Multi Max

> Use Multi Max in storekit to control how many of a single modifier option a customer can pick — separate from the group's overall maximum selection limit.

Multi Max controls how many of a single modifier option a customer can select. This is different from the group's `max` setting, which limits total selections across the entire group.

## How It Works

When `multiMax` is greater than 1 on a modifier group:

* A quantity stepper appears next to each selected modifier
* Customers can add multiple of the same option (e.g., 3x Extra Cheese)
* Each unit is priced and charged individually

### Example

A burger with a "Extras" modifier group:

| Setting      | Value                        |
| ------------ | ---------------------------- |
| **max**      | 5 (total extras allowed)     |
| **multiMax** | 3 (max per individual extra) |

Customer can select:

* 3x Extra Cheese
* 2x Extra Bacon
* Total: 5 extras ✓

But not:

* 4x Extra Cheese (exceeds multiMax of 3) ✗

## Max vs Multi Max

| Setting      | Controls                          | Example                   |
| ------------ | --------------------------------- | ------------------------- |
| **max**      | Total selections across the group | "Choose up to 4 toppings" |
| **multiMax** | Quantity per individual option    | "Up to 2 of each topping" |

When both are set:

* `max: 6, multiMax: 2` → Customer can pick up to 6 total toppings, but no more than 2 of any single topping
* `max: 0, multiMax: 3` → No total limit, but max 3 of each option

<Tip>
  Set `multiMax: 1` (the default) when customers should only be able to add each option once, like pizza base choices or drink sizes.
</Tip>

## Use Cases

### Extra Toppings

Allow multiple portions of premium toppings:

* "Add up to 3 portions of any topping"
* Each portion charged separately

### Shot-Based Drinks

Coffee shops offering multiple espresso shots:

* `multiMax: 4` for espresso shots
* Customer can order a quad-shot latte

### Sauces & Sides

Let customers load up on their favourites:

* "Extra sauce portions available"
* `multiMax: 3` for each sauce option

### Protein Add-Ons

Bowl or salad builders:

* "Double or triple your protein"
* `multiMax: 3` for chicken, tofu, etc.

## Setting Up Multi Max

1. Go to your [storekit dashboard](https://dashboard.storekit.com)
2. Navigate to **Menu**
3. Click into a product, then open a **Modifier Group**
4. Set the **Multi Max** value (e.g., 3 to allow up to 3 of each option)
5. Click **Save**