Skip to content

Promo Codes

Create and manage discount codes that customers apply at checkout.

Route

/admin/promo-codes

Overview

The Promo Codes page lists every discount code, with statistics, search, and filtering by status and scope. Creating, editing, and viewing a code all open in a slide-over panel on the list, so you never lose your place.

Dashboard Statistics

  • Total Codes - All codes, active and inactive
  • Active - Codes currently switched on
  • Total Usage - Combined redemptions across all codes
  • Expiring Soon - Active codes nearing their end date

Creating a Code

Click Create Promo Code to open the create panel. You can set:

  • Code - The text customers type (e.g. SUMMER20). 4-20 letters and numbers. Use Generate for a random code.
  • Discount - Percentage off, a fixed amount off, or free tickets.
  • Scope - All competitions (optionally excluding some), or only specific competitions.
  • Validity & restrictions - Valid from / valid until dates, max total uses, max uses per user, minimum spend, active toggle, and new-customers-only.

Editing a Code

Click the edit (pencil) action on any row to open the edit panel. Every setting can be changed except the code itself, including the Valid From start date and time.

If a code has already been used, a notice appears at the top of the panel: changes to the discount, scope, or restrictions apply to future redemptions only and never alter past orders.

Viewing a Code

Click the view (eye) action to open the details panel, which shows the code's statistics, full settings, and complete usage history (who used it, on which order and competition, and the discount applied). The Edit button in the panel takes you straight to the edit form.

Activating and Deactivating

Use the activate / deactivate action on a row (or the button in the details panel) to switch a code on or off. Deactivating stops the code working immediately without deleting it.

Deleting a Code

The delete (trash) action is available only for codes that have never been used. Deleting one of these removes it permanently and frees the code text, so you can create a new code with the same name.

A code that has already been used, or that a prize wheel awards, can't be deleted - the action deactivates it instead so its history and any wheel configuration stay intact.

  • Search - Match by code or description
  • Status - All, Active, or Inactive
  • Scope - All, Global, or Specific Competitions