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

# Bulk Buy Discount

> Reward participants who buy several tickets in one order with automatic discount programs, set up as quantity tiers for all your events or for chosen events, races and tickets.

> [!NOTE]
>
> You need an **Editor** or **Admin** role on the organizer account to create,
> edit or delete discount programs. With a **Viewer** role you can see your
> programs, but the create, edit and delete buttons don't appear. Ask your
> account owner for the right role if you need to make changes.

Bulk buy discount rewards participants who book several tickets in a single
order. You set it up as one or more **discount programs**. A program is a named
set of **tiers**, such as "5 or more tickets = 10% off", that applies to all
your events or only to the events, races or tickets you choose. Checkout applies
the discount automatically once a participant's basket reaches a tier. There's
no code for them to enter.

Use it to encourage group bookings from friends, clubs, teams and families.
Some ways to set it up:

* **One program for all events.** The simplest setup. New events are covered
  automatically.
* **A program per event or race.** For example, a bigger group discount on your
  flagship race and a smaller one on a new event.
* **A program for specific tickets.** For example, a discount on adult tickets
  only, so child or team tickets aren't discounted.

> [card] Percentage off
>
> Take a percentage off the qualifying tickets. For example, 10% off once the
> basket has 5 tickets.

> [card] Fixed amount off
>
> Take a fixed amount off the qualifying tickets once the basket reaches a
> tier. For example, \$20 off once the basket has 4 tickets.

## Discount eligibility

The discount is automatic. As a participant adds tickets to their basket,
checkout counts the tickets each program covers and applies the best tier they
qualify for:

* The discount only applies to **paid** tickets. Free tickets don't count toward
  a tier and never get a discount.
* Each program only counts the tickets it covers. A program for one race counts
  every ticket type in that race together. Tickets for other races don't count
  toward it.
* A **percentage** discount comes off the price of the qualifying tickets.
* A **fixed amount** discount comes off the qualifying tickets once the tier is
  reached.
* The participant always gets the **best tier their basket qualifies for**. If
  they reach a higher tier, the larger discount applies.
* One program applies per order. If a basket qualifies for more than one
  program, the participant gets the one that saves them the most.

For example, you have an all-events program of 3+ tickets = 5% off and a
program for your marathon of 5+ tickets = 15% off. A participant who books 5
marathon tickets gets 15% off. A participant who books 2 marathon tickets and 2
half marathon tickets gets 5% off, because only the all-events program counts
all 4 tickets.

When the discount is active, the participant sees it as its own line on the
order summary, with the amount deducted.

## Setting up a discount program

Go to **Growth** → **Bulk buy** in your dashboard. If you don't have any
programs yet, you'll see **Create your first discount program**.

**1. Create a program**

Click **Create program**.

**2. Name the program**

Under **Program details**, enter a **Program name** so you can recognize it
later, such as `Summer events discount`.

**3. Choose where it applies**

Under **Applicable events**, the program starts as **All events**. To narrow
it, click **Choose events, races or tickets** and select what it should
cover. You can mix events, races and ticket types in one program. Picking an
event covers every date of that event.

Leave it on **All events** if you want the program to cover every event,
including events you create later.

**4. Add discount tiers**

Under **Discount tiers**, fill in a tier:

* **Number of tickets**: the quantity a participant must reach to unlock
  this tier. The minimum is **2** tickets.
* **Discount type**: choose **Percentage (%)** or **Minus (-)** for a fixed
  amount.
* **Discount %** or **Discount** (shown with your currency symbol): the size
  of the discount. A percentage must be between **0 and 100**. A fixed
  amount must be **0 or more**.

Click **Add tier**. Repeat to build a ladder of discounts that grows with
basket size. For example, 2+ tickets = 5% off, then 5+ tickets = 10% off.
Tiers are sorted by ticket count. If you add a tier with a ticket count that
already exists, the new tier replaces the old one. To remove a tier, click
the delete button next to it.

**5. Save the program**

Click **Create program**. The button stays disabled until the program has a
name and at least one tier. The discount goes live at checkout as soon as
you save.

## Editing and deleting a program

Your programs are listed on the **Bulk buy** page with their tiers and the
events they cover. Programs that cover everything show **All events**.

* To change a program, click the edit button on its row, make your changes and
  click **Save changes**.
* To remove a program, click the delete button on its row and confirm. The
  discount is removed from checkout straight away. Orders already placed keep
  their discount.

## Turning the discount off for an event

Each event has an **Enable Bulk Buy discounts** toggle in its **Sales options**.
It's on by default. Turn it off for any event you don't want discounted.

> [!WARNING]
>
> If a participant's basket contains a ticket for an event with **Enable Bulk
> Buy discounts** turned off, no bulk buy discount applies to that order. This
> is true even for tickets from other events in the same basket. The event
> toggle overrides your programs, including a program that names that event.

If a program isn't applying, check the toggle in **Sales options** for each
event in the basket first.

## Baskets with tickets from several events

For a program to reward a basket that spans several of your events,
participants need to be able to add tickets from different events to one
basket. That requires **Multibuy** in each event's **Sales options** to allow
tickets from your other events. If you keep Multibuy to a single event only,
the discount still works within that event's basket. It just won't combine
tickets across events.

## Participant checkout experience

As participants choose tickets, a banner highlights the discount and nudges
them toward the next tier. The exact message depends on where they are:

| Situation | What the banner says |
| - | - |
| They haven't reached a tier yet | "Add 2 more tickets to save 10%" |
| They've earned one tier and a bigger one is available | "You saved 5%. Add 3 more tickets to save 10%!" |
| They've reached your top tier | "Save up to 10% with group registration" |
| The discount is applied to their order | "10% group discount applied" |

When a program covers a single ticket type, the banner names that ticket, for
example "Add 2 more "Adult" tickets to save 10%". If you've set up more than
one tier, the banner also shows the full ladder so participants can see what's
on offer, for example "2 or more = save 5%" and "5 or more = save 10%". When
more than one program could apply, the banner lists each one under **Discounts
available**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.