> For the complete documentation index, see [llms.txt](https://docs.rafflex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/ticket-limits-explained.md).

# How Ticket Limits Work

How Max tickets, Max per user, Max per order and the site wide Max Tickets Per Order setting work together, and what customers see when they reach a limit.

**The short answer:** every competition has a total number of tickets (**Max tickets**), and you can also limit how many one customer can buy in total (**Max per user**) and in a single order (**Max per order**). A site wide setting adds one more cap per order. When a customer picks their tickets, they can only ever choose up to the **smallest** of the limits that apply to them, and tickets already in their basket count towards every limit.

This page explains each limit, how they combine, and what your customers see along the way.

***

### The four limits at a glance

| Limit                     | Where to find it                                                          | What it controls                                                                                                       | Leave empty for                |
| ------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| **Max tickets**           | On the competition form                                                   | The total number of tickets in the competition. When they are all sold, the competition is sold out.                   | Required, cannot be left empty |
| **Max per user**          | On the competition form                                                   | The most tickets one customer can have in this competition, across all of their orders.                                | No per customer limit          |
| **Max per order**         | On the competition form                                                   | The most tickets of this competition a customer can buy in one order.                                                  | No per order limit             |
| **Max Tickets Per Order** | **Settings**, then **Checkout**, in the **Order & Cart Settings** section | A site wide cap on how many tickets of a competition a customer can buy in one order. It applies to every competition. | Required (default 1000)        |

{% hint style="warning" %}
**For no limit, leave the box empty.** Do not type 0 into **Max per user**. An empty box means no per customer limit, but a 0 can stop customers getting through checkout with tickets for that competition. Leaving **Max per order** empty is also the clearest way to say "no limit".
{% endhint %}

***

### Max tickets

**Max tickets** is the size of your competition. Think about your prize value, your ticket price and how quickly you expect to sell, then set the number of tickets accordingly.

* As tickets sell, the progress bar on your competition fills up, and the most a customer can choose shrinks to match what is left.
* Once every ticket is sold, the competition is marked as sold out.

{% hint style="warning" %}
**You cannot reduce Max tickets once instant wins are added.** Instant win prizes are tied to tickets in your competition, so the ticket count is locked from going down once any [instant wins](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins.md) exist. The field shows the message "Cannot reduce max tickets when instant wins are assigned." You can still increase it. Set your ticket count carefully before you add instant wins.
{% endhint %}

***

### Max per user

The helper text reads "Limit the amount of tickets a user can buy in this competition."

**Max per user** counts every ticket a customer already holds in the competition, from every order they have placed, plus anything already in their basket. If a customer has a limit of 50 and already owns 30 tickets, they can add up to 20 more.

* **Customers must be logged in.** When a competition has a Max per user limit, guests who try to add tickets are asked to log in so the system can check their eligibility.
* **A limit of 1 means exactly one ticket.** If you set Max per user to 1, the slider or number box is hidden, the only quantity on offer is 1, and each customer can have a single ticket.
* **Bonus tickets count.** Free tickets from a promotion are counted in the customer's total (see [Promotions and limits](#promotions-and-limits) below).

***

### Max per order

The helper text reads "Limits tickets per single order. Works alongside max per user, which limits total tickets across all orders."

Use **Max per order** when you are happy for customers to come back and buy again, but want to stop very large single purchases. For example, a Max per user of 100 with a Max per order of 25 lets a customer buy up to 25 at a time, up to 100 in total.

**Max per order** cannot be higher than **Max per user**. If you try to save a higher number, the form shows "Max per order cannot be more than max per user." and you need to lower it before you can save.

***

### The site wide Max Tickets Per Order setting

This setting lives outside the competition form and applies to every competition on your site. It caps how many tickets of any one competition a customer can buy in a single order. Its default is 1000.

To change it:

1. In the **admin panel**, find the **Content** group in the left-hand menu and click **Settings**.
2. In the Settings side menu, click **Checkout**. The page title reads **Checkout & Wallet**.
3. Find the **Order & Cart Settings** section.
4. Change **Max Tickets Per Order**, then click **Save Settings**.

A competition's own **Max per order** works within this site wide cap. For more about this page, see [Order & Cart Settings](https://docs.rafflex.io/additional-settings/settings/order-and-cart-settings.md).

***

### How the limits combine

A customer can never buy more than the **smallest** of these:

* The tickets still available in the competition.
* What is left of their **Max per user** allowance (if set, and they are logged in).
* The competition's **Max per order** (if set).
* The site wide **Max Tickets Per Order**.

Anything already in their basket for that competition is taken away from that number.

**Example.** A competition has 2,000 tickets left, a Max per user of 100, a Max per order of 40, and the site wide setting is 1000. A logged in customer who already owns 70 tickets can add up to 30 (the 30 left of their 100 allowance is smaller than 40). If they already have 10 in their basket, they can add 20 more.

***

### What customers see

The ticket selector on the competition page always works within the customer's remaining allowance, so they cannot pick more than they are allowed.

* **The slider or number box stops at the right number.** Its maximum is the customer's remaining allowance, and the range shown under the slider reflects it.
* **Quantity buttons adapt.** Any quantity button bigger than the customer's allowance is hidden. When you set a **Max per order**, buttons above it are removed, and a button for the Max per order amount is added if it is not already one of the options.
* **The limits are shown.** Under the ticket total, customers see a short note such as "Max 100 per user · Max 40 per order", so they know the rules up front.
* **Nothing left to add.** When a customer has used their whole allowance, the selector is replaced with a message explaining why. For example, "You already have 40 tickets for this competition in your basket, the most you can add." or "You have reached the maximum of 100 tickets allowed for" followed by the competition name.

The same limits apply if a customer changes the quantity from their basket.

{% hint style="info" %}
Whether customers use a range slider or a number box with quick add buttons is a site wide choice. See [Ticket Selector Style](https://docs.rafflex.io/additional-settings/settings/ticket-selector-style.md).
{% endhint %}

***

### Promotions and limits

Free bonus tickets from **Buy One Get One Free** and **Bundles** promotions count towards **Max per user** and **Max per order**, alongside the paid tickets.

If a customer's paid tickets plus their bonus tickets would go over a limit, they are not quietly given fewer free tickets. Instead, when they try to add the tickets, they see a message explaining that the total including bonus tickets exceeds the limit, and they are asked to reduce their quantity.

When you set up a promotion alongside a limit, leave enough room for the bonus. For example, with "buy 10 get 10 free", a Max per order of 20 lets a customer claim the full offer, but a Max per order of 15 does not.

{% content-ref url="/pages/31ed1odKKDQil7CxLatb" %}
[How Bonus Tickets Are Counted](https://docs.rafflex.io/marketing/website-tools/promos-and-discounts/how-bonus-tickets-are-counted.md)
{% endcontent-ref %}

***

### Free competitions

A competition is free when its **Price** is 0. Free competitions have a few extra rules to keep them fair:

* **Max per user is required.** The form will not save a free competition without it.
* **The most you can set is 25.** The helper text changes to "Free products are limited to a maximum of 25 tickets per customer." and a higher number is refused with "Free products cannot have more than 25 tickets per customer."

To limit a free competition to customers who have recently bought from you, use **Active Players Only** in the competition's Optional Extras. See the Visibility & Eligibility panel in [Create a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition.md) and [Creating a Free Entry Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition/creating-a-free-entry-competition.md).

***

### Instant wins that pay site credit

If your competition has instant wins that pay out site credit, the total of those payouts must not be more than your **Price** multiplied by **Max tickets**. This stops a competition from promising more in site credit than it could ever take in ticket sales.

If it would be more, the competition cannot be saved with **Active** switched on. A message under the toggle starts "Cannot activate: site credit payouts...". If you lower the **Price** of an active competition too far, a message under the price explains that the new price would make maximum revenue less than the site credit payouts. To fix it, raise the price or the number of tickets, or reduce the site credit prizes. Free competitions are not checked. On a [Prize Choice](https://docs.rafflex.io/create-your-first-raffle/prize-choice.md) competition, its prizes count towards this total too, so you can see these messages even with no instant wins.

{% content-ref url="/pages/oQGhFbfiF5FbsLvXtpni" %}
[The Instant Win Budget Bar](https://docs.rafflex.io/create-your-first-raffle/add-instant-wins/instant-win-budget-explained.md)
{% endcontent-ref %}

***

### Choosing sensible limits

* **For most paid competitions,** set Max tickets and leave the per customer limits empty. The site wide setting still stops extreme single orders.
* **To spread entries across more customers,** set a Max per user. Remember that customers will need to log in before adding tickets.
* **To slow down big single purchases but allow repeat visits,** set a Max per order lower than Max per user.
* **When running a promotion,** check your limits leave room for the free tickets.
* **Before you add instant wins,** double check your Max tickets, as you cannot lower it afterwards.

***

### Related pages

{% content-ref url="/pages/rwVEXhq1XlXV2IEw8J1J" %}
[Create a Competition](https://docs.rafflex.io/create-your-first-raffle/create-a-competition.md)
{% endcontent-ref %}

{% content-ref url="/pages/HDZdBWPtfDdEbAloNC9p" %}
[Order & Cart Settings](https://docs.rafflex.io/additional-settings/settings/order-and-cart-settings.md)
{% endcontent-ref %}
