---
title: "Products"
slug: "event-products"
tags: ["Events"]
updated: 2025-04-28T20:34:50Z
published: 2025-04-28T20:34:50Z
canonical: "docs.blackthorn.io/event-products"
---

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

# Products

Out of the box, you can create a Product, provide a description, define the sales start and end dates, and track the quantity sold. In addition to the items just described, we also provide the features covered below.

## Sandbox Pre-requisite

If you create an Event Item with **Address** set to “Optional” or “Required” in a Sandbox, you must set the **Country** field to “Required.” You will get an error if the **Country** field is set to “Hide” (default setting).

## Event Page Layout

The section “Products” was added to the Event page layout. The Products section will include the following fields: **Item Name**, **Attendee**, **Attendee Full Name**, **Event**, and **Unit Price**.

![Products Section on Event Object](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Products%20Section%20on%20Event%20Object.png)

---

![ev1807 pic 5_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/ev1807%20pic%205_2.png)

### New Fields

You may need to manually add new fields to the Attendee page layout, as they may not be added by default.

#### Event Item Type

- Field Label: **Event Item Type**
- Field Name: conference360__Event_Item_Type__c
- Data Type: Formula(Text)
- Location: Line Item object
- Purpose: a text formula field that shows the type of Event Item

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

#### Purchased Products

- Field Label: **Purchased Products**
- Field Name: conference360__Purchased_Products__c
- Data Type: Checkbox
- Location: Attendee object
- Purpose: a checkbox field that shows whether an Attendee purchased a Product

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

### Functionality

#### Event Item Record

- The Event Item **Type** for a Product is "Other".
- If a Product is added on the Event Item, it will be carried to the Line Item on the Invoice.

#### Line Item Record

- The **Event** lookup field has been added to the Line Item record to show which Event the Product is related to.

#### Checkout Process

- A Product’s information is added to a selected Attendee when the Product is added to the cart.
- If a Product’s information has not been added to an Attendee, the Product’s information will be added to the first Attendee.

## Create a Product

1. Once a Main event ticket has been created, open a New Event Item window and add the following information to create a Product.

### Information & Description

- Enter a **Public Item Name** (required).
- Select an **Event**.
- Enter an amount in the **Price** field.
- Set **Type** = "Other".
- Select a **Visibility Control**, if using.
- Check **Waitlist Enabled** to enable waitlisting.
- Enter a **Description**.
- Enter a value in the **Sort Order** field to change the order of the Event Items on the registration page.  

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

### Availability & Limits

Enter information about the sales start/end dates.

- **Sales Start Date**
- **Sales End Date**
- **Sales Start Time**
- **Sales End Time**

### Capacity & Waitlisting

- Enter the **Quantity Available**. If the field is left blank, the **Quantity Available** will say “999,999”.
- The **Quantity Remaining** field updates automatically based on the equation, **Quantity Available** - **Registered Quantity** = **Quantity Remaining**.
- If waitlisting is enabled, enter an amount in the **Waitlist Capacity** field, if using. For more information about waitlisting, click [here](https://docs.blackthorn.io/docs/event-waitlisting).
- Enter a value in the **Default Quantity Selection** field to define the default quantity of Tickets, Guest Tickets, or Products that will be automatically added to the cart when an Attendee reaches the ticket selection step. If the number of remaining tickets is greater than 0 but less than the **Default Quantity Selection**, all remaining tickets will be added to the cart.
  - NOTE: When an Attendee purchases Tickets, Guest Tickets, or Products from their AttendeeLink, the default quantity will not be added to the cart. (The original behavior is unchanged.)
- The **Waitlisted** field will provide a summary of the Attendees who are waitlisted for the Event Item.

![Create Tickets Capacity Waitlisting](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Create%20Event%20Item_new%20default%20qty%20selection%20field.png)

### Attendee Form

There are multiple fields on the Attendee Form that you can hide, make required, or show as optional for each Donation.

For example, if you have a "Child Under 3 Yrs" ticket for sale, it is very unlikely that the child does not have an email address. You can hide the **Email** field from this Event Item's Attendee Form.

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

Select “Hide”, “Optional”, or “Required” for each of the fields below.

- **Company**
- **Country**
- **Email**
- **Full Name**
- **Phone**
- **Title**
- **Address**
- **Dietary Preference**
- **Salutation**
- **Account Postal Code**

**Important Functionality:** If an Event Item’s **Account Postal Code** is set to “Required,” but the **Address** field is set to “Hide” or “Optional,” then a registrant will not be able to complete the registration process.

#### Live Attendee Form Example

![View Live Attendee Form2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/View%20Live%20Attendee%20Form%282%29.png)

1. Click **Save & New** to create a new Event Item or click **Save**.

### Other Settings

- Check **Hidden** if you would like to hide the Event Item from the Event checkout process.
- To set a minimum or a maximum number of Event Items allowed per order, enter the amounts in the **Maximum Quantity** and/or **Minimum Quantity** fields.
- The **Maximum Quantity** or number of Event Items that can be purchased at one time cannot be larger than 10. Please contact [Blackthorn Support](https://community.blackthorn.io/s/support-request) if you would like to increase the number to 25.
- Select a previously created Form or create a new one. Click [here](https://docs.blackthorn.io/docs/custom-questions) for more information about creating Forms and Form Elements.
- An Event Item’s **Quantity Remaining** will show on the registration page only when there are 10 or fewer Event Items available.
- If you want the Donations and Products sections to be on their own pages, set the Event Settings field **Display Donations & Products separately** to “Yes” (checked). To continue using the current functionality, leave **Display Donations & Products separately** set to “No” (unchecked).
  - Note: If a Form is related to a Donation or Product record, the Form will be displayed on the page with the Donation or Product.

## Data Dictionary and Product Counts

The [Data Dictionary](https://docs.blackthorn.io/docs/data-dictionary) can help Event Organizers inform potential Attendees of the number of available Tickets, Session spots, and Products using the following Keys.

- **Key** = “LBL_COUNT_TICKETS_REMAINING”
- **Key** = “LBL_COUNT_ITEMS_REMAINING”
- **Key** = “LBL_COUNT_SPOTS_REMAINING”
- **Key** = “MSG_QUANTITY_TICKET_WAITLISTED”

IMPORTANT NOTE: These Keys do not work for Donations.

### Create a Data Dictionary Group

ImportantCapital letters must be used in the **Key** field. 

1. In the App Launcher, enter and click "Data Dictionary Group".
2. Click **New**. ![CreateDataDictionaryGroup_Object](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CreateDataDictionaryGroup_Object.png)
3. Enter a **Data Dictionary Group Name**.![CreateDataDictionaryGroup_New](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CreateDataDictionaryGroup_New.png)
4. Click **Save**.

### Create Data Dictionary Entries

To show the amount of available Tickets, Sessions, or Products, you must include "{count}" in the **Value** field.

1. Click **New** next to the Data Dictionary Entry. In a Data Dictionary Group, each Data Dictionary Entry can only support one language. ![CreateDataDictionaryGroup_NewEntry](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/CreateDataDictionaryGroup_NewEntry.png)
2. In this example, we’ll set **Language / Locale** to “English.”
3. For Event Items with **Type**set to “Main event ticket” or “Guest,”
  1. Set **Key** = “LBL_COUNT_TICKETS_REMAINING”
  2. Set **Value** = “{count} Tickets Left in Event”
4. Click **Add Row**.
5. For Event Items with **Type**set to “Other” (Products),
  1. Set **Key** = “LBL_COUNT_ITEMS_REMAINING”
  2. Set **Value** = “{count} Products. Left in Event"
6. Click **Add Row**.
7. For Sessions,
  1. **Set Key** = “LBL_COUNT_SPOTS_REMAINING”
  2. **Set Value** = “{count} Tickets Left in Session”
8. Click **Add Row**.
9. For waitlisted Tickets (Event Items with `Type` set to “Main event ticket” or “Guest”),
  1. **Set Key** = “MSG_QUANTITY_TICKET_WAITLISTED”
  2. **Set Value** = “[count] Waitlist Spots Left”![](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Data%20Dictionary%20Key%20Counts.png)
10. Click **Save**.
11. Click **Back** to return to the Data Dictionary Group record.

Click [here](https://docs.google.com/spreadsheets/d/1mANZ058qszzrXjEdB0Wv4AVbcN5aj41h7-qd9XtrRy0/edit?usp=sharing) for the full Events Data Dictionary list.