> For the complete documentation index, see [llms.txt](https://eventx-hq.gitbook.io/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eventx-hq.gitbook.io/knowledge-base/registration-and-ticketing/ticketing-and-pricing/creating-promo-codes.md).

# Creating Promo Codes

Promo codes are codes that customers can enter at checkout to receive a discount on their event ticket purchases. These codes are usually a combination of letters and numbers and can be found through the organizer's promotional channels.

### Adding & Editing a Promo Code

**Note:** To start with creating a Promo code, you will have to set up at least 1 Ticket on the organizer portal first.

**1. Access Promo Code page.** From the left-hand navigation, click **Promo Code**, and click **Create**.

![](/files/f6rRjyr1MxLCD4E5LF5q)

**2. Enter the Promo code details.** Name your promo code. Each code must be unique with 20 characters or less. Promo codes cannot have duplicates.

![](/files/tBRsx5p5tTOKSb1lgZ9N)

Then select the **Discount types**:

* **Subtract by $:** the ticket fee will subtract from the entered amount
* **Subtract by %:** the ticket fee will subtract from the entered percentage
* **Charge by $:** the ticket fee will charge by the entered amount

**Note:** Price will follow your currency setting. Please make sure the ticket price >= $0.75 or = $0 after applying the code. Or there will be a minimum price of $0.75 per order.

![Screen\_Shot\_2023-03-14\_at\_1.36.56\_PM.png](/files/EP7eB4fADWDTrkq2qs4j)

Enter the amount or percentage in the amount/percentage field.

Select if the promo code applies to All ticket types, or to specific ticket types only.

![promo\_code.gif](/files/QId99v6q4OCUDu1tsznW)

Setting a quota limits the number of times this code can be used or an unlimited quota.

![Screen\_Shot\_2023-03-14\_at\_1.42.16\_PM.png](/files/3WFYG6kqbnDJXUfXlpgP)

Finally, schedule the valid period of the promo code and click **Save**.

![Screen\_Shot\_2023-03-14\_at\_1.43.44\_PM.png](/files/BdL2nNRsYhP1pA6Ti6eP)

**3. Edit Promo Code.** Click on the edit icon to edit the promo code. You can do so even while the promo code is active.

![](/files/oTMumJTD0YMfeutf2oX0)

**Note:**

* The quota limit can be edited, but the new quota number MUST be larger than the number of quotas used.
* Promo code date can also be edited, but the promo code end time MUST be earlier than the event end time.
* Once the promo code has been created, it cannot be deleted anymore but it can be unpublished by toggling off the ***Publish*** toggle.

After finishing the editing, you can toggle it to **Active** to allow registrants to use it for registration.

## Promo Code Logic

1. Currently, the promo code quota will be deducted per ticket purchased. For example, if the attendee purchases 2 tickets in one registration, the promo code quota deducted will be 2.
2. If the promo code quota is set to a certain number, the purchaser cannot apply the promo code when purchasing more than the promo code quota. For example, if the quota is 2, the attendee cannot purchase 3 tickets in one registration.\
   ![](/files/Z3IrKOxvbWoQPC77r7jC)

### **Example**

Attendee purchases 2 tickets and the promo code is applied.\
![](/files/1m06VZSmXWDwNpmIaxce)\
2 promo code quota deducted.\
![](/files/hFqefkBseJkGLzqUD18D)

### Applying a Promo Code on Registration

On the event landing page, after the registrants selected a Ticket Type, they can type in the Promo code and click \*\*Apply.\*\*It will then show if the code can be applied successfully or not.

**Note:** Promo codes are case-sensitive.

![](/files/MZ1dVrhnYziqhqjlWbSO)

If attendees insert an invalid code, they will see a warning message *"Sorry, this code is invalid"*.

![](/files/e4ZMvPbiNoJSJTD9pH3y)

When the Promo code entered has reached its full quota usage, you will see a warning message\
\&#xNAN;*'Sorry, the quota of this promo code has been used up'.*

![](/files/r5buQiyTdvdGv7U2sV9t)

## Order Summary

Once the ticket has been selected and the promo code has been applied successfully, the attendee will be able to view the order summary.\
**Note**

1. On the order summary, the type of promo code applied will be shown together with the total price that needs to be paid.\
   ![](/files/RRoDkTn66Jd1vRiPizGr)

## Frequently Asked Questions

### Q: What happens when the promo code quota is exceeded?

**A:** The promo code can no longer be applied. The quota is deducted per ticket purchased. If a purchaser tries to buy more tickets than the remaining quota, the promo code will not apply.

### Q: Can I set a promo code to only work during a specific time period?

**A:** Yes. Set a start and end date/time when creating the promo code. Outside this window, the code cannot be applied.

### Q: Can the same promo code be used by multiple attendees?

**A:** Yes, as long as the usage quota has not been exhausted. The quota is configurable per promo code.
