Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jointoevent.io/llms.txt

Use this file to discover all available pages before exploring further.

Discount codes (also called promo or coupon codes) let you offer reduced prices to specific attendees or groups without changing your published ticket prices. You define the code, the discount amount, and which tickets it applies to. Attendees enter the code during registration to have the discount applied automatically before payment.

The discount code list

Open your event and click Discount codes in the sidebar. The table lists all codes for the current event. You can search for a specific code by typing in the search field — results update automatically as you type, and pressing Enter triggers an immediate search. The table shows the following columns for each code:
ColumnWhat it shows
CodeThe promo code string (code)
Coupon nameThe internal label for this code (name)
UsedHow many times the code has been activated (timesUsed) out of the allowed maximum (maxUseCount)
Discount valueThe discount amount (discount)
Assigned ticketsWhich tickets the code is valid for, or “All tickets” if unrestricted
Click the eye icon in the Used column to open a dialog listing the attendees who have used that code.

Creating a discount code

Click + Add discount code in the top-right corner of the list.
1

Name the coupon

name
string
required
An internal label for this coupon or batch of coupons. This name is visible to you in the panel but not to attendees.
2

Choose single code or bulk generation

You can create one specific code or generate multiple random codes at once:

Single code

Enter a value in Coupon code. Leave Number of codes blank. The code must be unique for this event.

Bulk codes

Leave Coupon code blank and enter a number in Number of codes (maximum 250). JTE Panel generates that many unique codes automatically.
code
string
The exact promo code string attendees will enter. Required when creating a single code. Must be left blank when using bulk generation.
amount
number
Number of codes to generate automatically. Required when creating multiple codes. Must be left blank when entering a specific code.
You cannot set both a specific code and an amount at the same time. The form blocks submission if both fields contain values.
3

Set the activation limit

maxUseCount
number
The maximum number of times this code can be activated across all attendees. Leave blank to allow unlimited activations.
4

Set the discount value

discount
string
required
The discount to apply when the code is used. Enter a numeric value. Use the Percentage discount toggle to switch between a percentage off the ticket price (isDiscountPercentage: true) and a fixed cash amount (isDiscountPercentage: false).
Setting the discount to 100 with percentage mode enabled creates a fully free code — useful for press passes or speaker registrations.
5

Assign a role (optional)

roleId
string
Optionally assign a role to attendees who redeem this code. This lets you segment attendees by the code they used.
6

Restrict to specific tickets (optional)

assiociatedTickets
string[]
Select one or more tickets this code is valid for. If you leave this field empty, the code works with every ticket type on the event.
Leaving Code active for empty makes the code universal — any attendee registering with any ticket can use it.
7

Save the code

Click Save. The button is disabled until the form is valid. You are returned to the code list once the code is created.

Editing a discount code

In the code list, open the actions menu (gear icon) on the code row and click the pencil icon. The edit form loads the existing values. Update any field and click Save.
The Coupon code field is read-only when editing an existing code. You cannot change the code string after creation. To use a different code, delete the existing one and create a new code.

Deleting a discount code

Open the actions menu on a code row and click the trash icon. The code is removed immediately without a confirmation dialog.
Deleting a discount code is immediate and permanent. Attendees who have already used the code keep their discount, but the code can no longer be used for new registrations.

How attendees use discount codes

When an attendee reaches the payment step during registration, they see a Promo code field. They type the code and apply it. If the code is valid for their selected ticket and has not exceeded its maxUseCount, the discount is applied to the total before payment is processed.
If payment is disabled for your event entirely, attendees skip the payment step and the promo code field is not shown. See Payment settings for details.