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

# Free Modifiers

> Offer customers a set number of free modifier selections before charging for additional choices. Common for pizza toppings, salad bars, and bowls.

Free modifiers let you offer customers a set number of complimentary selections from a modifier group before charging for additional choices. This is commonly used for pizza toppings, salad add-ons, or drink customisations.

## How It Works

When you set a free modifier count on a modifier group:

1. The first N selections are free (no additional charge)
2. Selections beyond the free limit are charged at their listed price
3. Pricing updates automatically as customers add or remove selections

### Example

A pizza with `freeModifiers: 3` on the "Extra Toppings" group:

| Selection                  | Price Charged |
| -------------------------- | ------------- |
| 1st topping (Pepperoni)    | Free          |
| 2nd topping (Mushrooms)    | Free          |
| 3rd topping (Olives)       | Free          |
| 4th topping (Extra Cheese) | £1.50         |
| 5th topping (Jalapeños)    | £1.50         |

## Setting Up Free Modifiers

<Info>
  This feature requires support to enable for your account. [Contact support](/getting-started/contact-support) to request access.
</Info>

Once enabled, provide support with:

1. The modifier group name or ID
2. The number of free selections to allow

## Use Cases

### Pizza Toppings

"Choose up to 3 toppings included, additional toppings £1.50 each"

* Set `freeModifiers: 3` on the toppings modifier group

### Build-Your-Own Bowls

"Includes 4 ingredients, extras charged separately"

* Set `freeModifiers: 4` on the ingredients modifier group

### Coffee Customisations

"First flavour shot free, additional shots 50p"

* Set `freeModifiers: 1` on the flavour shots modifier group

### Salad Bar

"Choose 5 toppings with your salad"

* Set `freeModifiers: 5` on the toppings modifier group

## POS Integration

### Zonal (Aztec)

When importing menus from Zonal (Aztec), the "inclusive" count from choice groups is automatically mapped to `freeModifiers`. If any modifier in the group has a supplemental price, the inclusive count is set to 0 (all selections are charged).

## Pricing Logic

The system automatically applies free allocations to the **most expensive** selections first, ensuring customers always get the best deal:

1. All selected modifiers are sorted by price (highest first)
2. Free allocations are applied starting with the most expensive items
3. Cheaper items are charged if selections exceed the free limit

### Example

With `freeModifiers: 2` and these selections:

* Bacon (£2.00)
* Cheese (£1.50)
* Peppers (£0.50)

Result:

* Bacon: **Free** (most expensive)
* Cheese: **Free** (second most expensive)
* Peppers: **£0.50** (charged)

<Tip>
  Customers don't need to think about selection order - the system always optimises to give them the maximum discount automatically.
</Tip>