For the complete documentation index, see llms.txt. This page is also available as Markdown.

Promos and Discounts

There are two ways to apply discounts in RaffleX:

  1. Site-wide discounts using coupon codes

  2. Competition-specific promotions (BOGO and Bundles)


1. Creating a Site-Wide Discount (Coupons)

To create a discount that applies across your site:

  1. Click Coupons in the left-hand menu.

  2. Click Add New Coupon.

  3. Enter the Coupon Title (this is for your reference).

  4. Set the Discount Type:

    1. Percentage Discount – e.g., 10% off.

    2. Fixed Discount – e.g., £5 off.

  5. Manually create a Discount Code.

  6. Set the Expiry Date.

Additional Coupon Settings

  • Usage Limits – Set how many times the code can be used in total.

  • User Limits – Limit how many times an individual customer can use the code.

  • New Customers Only – Tick this box if you want the discount only for new customers.

  • Spend Limits – Set a minimum spend required before the coupon can be used, and/or a maximum spend above which the coupon will no longer apply. The maximum is an upper basket limit, not a cap on the discount, so a basket worth more than it will be told the code cannot be used.

  • Competition Restrictions – Choose to include or exclude specific competitions from the discount.

Once set, save the coupon, and it will be active immediately.

A code can be active and still be refused at the basket. "Active" only means the code exists and has not expired. The settings above (new customers only, spend limits, usage limits, and competition restrictions) are each checked when a customer tries to use it. If you are testing a promo and it will not apply, see Why a Discount Code Won't Apply for what each on-screen message means.


2. Competition Specific Discounts

To add a discount inside an individual competition, follow these steps:

  1. Go to Competitions in the admin panel.

  2. Select the competition you want to apply a promo to.

  3. Find Promotion Type on the right-hand side, just above where you add images.

  4. Choose either Buy One Get One Free or Bundles.

Buy One Get One Free (BOGO)

  • Set the minimum ticket purchase required to unlock the promo (e.g., buy 5 tickets to get extra 5 free).

  • Set the maximum limit (optional).

The maximum here is a cut-off, not a cap, and your free tickets count towards your per customer and per order limits. To make sure customers can claim the full bonus you advertise, see How Bonus Tickets Are Counted (and Capped).

Bundles (Buy X, Get X Free)

You can create multiple discount tiers, such as:

  • Tier 1 – Buy 5 tickets, get 2 free.

  • Tier 2 – Buy 10 tickets, get 5 free.

  • Tier 3 – Buy 20 tickets, get 10 free.

Once configured, save the competition, and the discount will be applied.


Wondering whether a customer can use a coupon code, a quantity discount and a Buy One Get One Free offer all at once? They cannot. RaffleX only ever applies one discount at a time and works out the single best one. For the full explanation, see Do discounts stack?

Once your codes are live, you can check how each one is performing (usage, total discount given, and return on investment) with the Coupon ROI Analysis report.

Last updated