---
title: "Discount Codes"
slug: "event-discount-codes"
tags: ["Events"]
updated: 2025-09-20T00:07:46Z
published: 2025-09-20T00:07:46Z
canonical: "docs.blackthorn.io/event-discount-codes"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackthorn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Discount Codes

Codes can be used for specific Events, or Event Items. Three types of Codes can be added to Events and Event Items:

- **Discount:** decreases the dollar amount an individual will pay
- **Access-Promo:** access to proceed or purchase an item or a promotional code for an item benefit
- **Source:** While the “Source” option can track a code to follow a user through a flow, like an embedded URL, we recommend using a [UTM parameter for tracking](https://docs.blackthorn.io/docs/create-form-elements#utm-parameter) instead.

## Prerequisites

### Licenses

Codes are a part of the Blackthorn Payments package. The user configuring discount Codes will need a license for the Payments app.

### Page Layout Updates

#### Code Eligibility Object

If you do not see the **Event** or **Event Item** fields on the Code Eligibility record, update the page layout to include them.

#### Event Item Object

Add the Code Eligibility’s Related List to the Event Item object.

## Important Functionality

- Discount Codes are only supported for the Full-Width, Tabbed, and Dynamic UI experiences. Using a discount Code with the Simple UI will cause the checkout process to fail.
- Discount Codes are not supported for Sessions.

## Create a Discount Code

1. Click on the App Launcher.
2. Enter and select “Codes.”
3. Click **New**. ![Create a Code 1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1710966423218.png)
4. Define the following fields:
  - Enter the **Code Name**. (required)
  - Choose a **Valid From** date.
  - Choose the **Valid Through** date. *NOTE:* **Valid From** and **Valid Through** dates are enforced depending on which field is set.
  - **Restrict To Account** (If set, only Contact associated to the Account can use the Code.)
  - Enter the **Quantity Made Available**. *NOTE:* **Quantity Made Available** is enforced only when populated (leave blank for unlimited uses). The related **Quantity Claimed** field is updated every time a Code is used on an Invoice for an Event or Event Item. If an Invoice **Status** = "Void", the Code is released, and the **Quantity Claimed** is updated.
  - Select “Discount” in the **Type** field.
  - Enter the **Discount Amount** or the **Discount Percentage**.
  - Enter a **Description**.
5. Click **Save**. ![Create a Code 2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1707852100936.png)

### Create a Code Eligibility Record to Relate an Event or Event Item

1. Select a **Code**.
2. Choose either an **Event** or an **Event Item**.

*NOTE:* Code Eligibility can only be added to one of them.
3. Click **Save**.

![Releate an Event or Ticket 1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1707852145460.png)

### Enable the Discount Code on your Event Page

1. Go to the Event record.
2. Set the **Code Settings** field to “Optional,” “Hide,” or “Required.”
  - If **Code Settings** = “Required” on the Event, all Event Items must have an associated Code. Registrants won't be able to proceed with checkout unless they have the valid Code.
  - If **Code Settings** = “Optional,” then a registrant isn’t required to enter a Code even if the Code was set on the Event Item level.
  - If **Code Settings** = “Hide,” the Code will be hidden throughout the checkout process.

![Releate an Event or Ticket 2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Releate%20an%20Event%20or%20Ticket%202.png)

### Code Discount Amount Field

The amount an Event Item's Line Item was discounted by using a Code is calculated and stored in the **Code Discount Amount** field on the Event Item's Line Item on theInvoice.

### Multiple Registrants and a Discount Code

When a group of Attendees registers for an Event as a group and uses a discount Code during checkout, the discount Code will be applied to the group’s total cost and found on the Invoice record.

The discount Code will not be applied to each Attendee individually during the checkout process.

![Discount Codes_Group Discount.png](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Discount%20Codes_Group%20Discount.png)

## Create an Access-Promo Code

If no discount is offered, Codes can also give users special permission to purchase an Event Item (i.e., Ticket or Product) or to access an Event Item benefit.

1. Enter the **Code Name**. (required)
2. Choose a **Valid From** date.
3. Choose the **Valid Through** date. *NOTE:* **Valid From** and **Valid Through** dates are enforced depending on which field is set.
4. **Restrict To Account** (If set, only Contact associated to the Account can use the Code.)
5. Enter the **Quantity Made Available**. *NOTE:* **Quantity Made Available** is enforced only when populated (leave blank for unlimited uses). The related **Quantity Claimed** field is updated every time a Code is used on an Invoice for an Event or Event Item. If an Invoice **Status** = "Void", the Code is released, and the **Quantity Claimed** is updated.
6. Select “Access-Promo” in the **Type** field.
7. Enter the **Discount Amount** or the **Discount Percentage**.
8. Enter a **Description**.
9. Click **Save**.

![New Promo Access Code](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1707852289408.png)

### Create a Code Eligibility Record to Relate an Event or Event Item

1. Select a **Code**.
2. Choose either an **Event** or an **Event Item**.

*NOTE:* Code Eligibility can only be added to one of them.
3. Click **Save**.

![Releate an Event or Ticket 1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1707852343049.png)

### Enable Discount Codes on your Event Record

1. Go to the Event record.
2. Set the **Code Settings** = “Required.”

***NOTE:*** *This will make the Access-Promo Code required at the Event level.*

### Code Discount Amount

The amount an Event Item's Line Item was discounted by using a Code is calculated and stored in the **Code Discount Amount** field on the Event Item's Line Item on the Invoice.

![Creating Code](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/image-1707852451054.png)

### Reserve Seats for Attendees

You can also use an access-promo Code to reserve seats for Attendees by updating the following.

#### Code Eligibility Record

On the Code Eligibility record, select an Event in the **Event** field. *Do not* use the **Event Item** field.

#### Event Record

On the Event record, set the **Code Settings** field to “Required.” This will prevent Attendees from registering for the Event without using the access-promo Code.

## FAQ

**Q: How many Code Eligibility records can be enabled on an Event or an Event Item?**

A: There is no known limit for the number of related Code Eligibility records that can be enabled on an Event or an Event Item.

**Q: Can only one promo Code be used at a time? Or can users stack promo Codes?**

A: Only ONE promo Code can be used during checkout. If an Attendee has a few codes available for a given Event they can be swapped but not stacked.

**Q: Can I use a discount Code in the Experience Cloud?**

A: Yes, you can use discount Codes in the Experience Cloud if the following criteria are met.

- A user logged into an Experience Cloud site as a Contact related to an Account can apply a discount Code if...
  - The Account is related to a discount Code.
  - The Code’s **Restrict To Account** field is set to “True.”
- A user logged into an Experience Cloud site as a Contact related to an Account cannot apply the discount Code if...
  - The Account is NOT connected to a discount Code.
  - The Code’s **Restrict To Account** field is set to “True.”