# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eventx-hq.gitbook.io/knowledge-base/registration-and-ticketing/ticketing-and-pricing/creating-promo-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.