> For the complete documentation index, see [llms.txt](https://support.storefront.co.za/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.storefront.co.za/features/promotions/multi-buys.md).

# Multi-Buys

A multi-buy offers a discount or a special price when a customer buys a set number of items. It encourages a larger basket rather than a single purchase.

The best known example is buy one, get one free. Another is a percentage off the total when a customer buys several items, such as buy three and get 20% off.

### How to Add a Multi-Buy

1. Click on Promotions > Multi-Buys
2. Click on the Create button
3. Select which store the multi-buy belongs to
4. Enter the multi-buy name
5. Add the valid from and valid to dates
6. Select a multi-buy option
7. Configure the multi-buy using the fields that appear for the option you chose
8. Add your matching and excluded criteria, to control which products qualify
9. Click on Create

{% hint style="warning" %}
Test a multi-buy on your storefront before promoting it. Add the qualifying combination to a cart and confirm the offer applies as you intended, because the interaction between quantities and criteria is easy to get slightly wrong.
{% endhint %}

{% hint style="info" %}
Multi-buys can combine with other promotions in ways you may not expect. It is worth checking what happens when a product already carrying a discount also qualifies for a multi-buy.
{% endhint %}