Please review the updates below and follow the upgrade instructions to upgrade your Events application.
Table of Contents
Breaking Change
As of the March 5, 2025 Salesforce release, Caching 2.0 will be installed with the upgrade. Please follow the steps below to complete the process.
Install the Events app upgrade using the Candy Shop. (If you believe you need to use a direct link, please contact Blackthorn Support. They can provide you with the script and instructions for performing the process manually.)
Contact Blackthorn Support to request that the Caching 2.0 installation process be completed. Please include the Org ID for the environment where you want Caching 2.0 enabled.
Event Group Filters: When Caching 2.0 is enabled, the Event Group URL filters behave differently. The Event Group URL parameters used for filtering Event Groups must not include the Category as part of the URL filter, and Event Groups will show up empty.
Please read Keywords and Event Group Filters for specific information and examples before proceeding.
Off-Cycle Releases
March 25, 2025
If a Form Element contains a picklist value with a colon ( : ), Attendees will see the entire picklist value when selecting an answer. Previously, Attendees only saw the text after the colon. Ex. “Colors: Yellow and Blue” vs. “Yellow and Blue” (Known Issue: 000004540)
February 25, 2025
If reCAPTCHA is enabled for a free Event and an Attendee registers for a waitlist-only Event Item, they can complete the registration process. Previously, if the Event Settings Remove Info Page for Free Events field was enabled, the registration failed because the user could not respond to the enabled reCAPTCHA on the hidden Payments Info screen. (Known Issue: 000004427)
If an Event Group contains more than 2000 published and unpublished Events, the Attendee will see the published Events on the Event Group URL. Previously, Attendees got the “There are no upcoming events.” error when they clicked the Event Group URL because there was a 2000 Events per Event Group limit. (Known Issue: 000004535)
BT Salesforce Release
(Release Date: March 18, 2025)
Bug Fixes
Attendee Record: When a user registers an Attendee for an Event from the Event record and sets the Attendee’s Email Opt-in field to “True” (checked), the Email Opt-in field will be checked on the Attendee record. Previously, the Email Opt-in field on the Attendee record was not checked. (Known Issue: 000003813)
Waitlisting: When a paid Event has the UI Experience set to “Tabbed” and waitlisting is set at the Event level, an Attendee with Registration Status set to “Pending” can register for the Event from their AttendeeLink. Previously, Attendees could not register for the Event even though Tickets were available. (Known Issue: 000004422)
Duplicate Rules: Duplicate rules have been updated to ensure completed and processed registrations are handled by duplication logic when configured to block duplicates on creation. Now, duplicate rules will include Event Registration Submission (ERS) records with Status set to “To Process” and a value in the new Primary Email field. Previously, when duplicate rules were set to block, and a user registered twice while the first ERS record’s Status was still set to “To Process,” duplicate records/Invoices were created. (Known Issue: 000004328)
Object: Event Registration Submission
Field Label: Primary Email
API Name: conference360__Primary_Email__c
Data Type: Email
Help Text/Description: “The main email from the event registration. This field is automatically populated.”
Permission Set Updates
Read\Edit
Blackthorn | Events (Organizer)
Blackthorn | Events (Admin)
Blackthorn | Events (Community/Platform User)
Read
Blackthorn | Events (Lite User)
Blackthorn | Events (Read Only)
Blackthorn | Events (Limited Access)
New Logic
If the Event Settings Block Duplicate Registrations = “True” and an Attendee submits a registration that has an ERS record with Status set to “To Process” or “Completed” and the Primary Email field is populated, then the Attendee will get an error when they try to submit a duplicate registration.
If the Event Settings Block Duplicate Registrations = “False” and an Attendee submits a registration that has an ERS record with Status set to “To Process” or “Completed” and the Primary Email field is populated, then the Attendee will be able to submit a duplicate registration successfully.
Batch Jobs: When an Event Organizer uses the EventRevenueRollip batch job after an Event takes place, the job will calculate rollups and update revenue fields as expected. Previously, Event Organizers received the following error message on the EventRevenueRollupBatch job: "First error: Attempt to de-reference a null object." (Known Issue: 000004479)
Donations: When an Event Organizer adds a Tax Fee to an Event, Donations (Event Items with Type = “Donation”) will automatically be marked as Tax-Exempt. They will not be included in tax calculations, whether calculated at checkout or tax-inclusive. Previously, Donations were treated the same as the other Event Items in the cart and were included in any tax calculations.
Permissions: Mobile Check-in app users can change an Attendee’s email address and successfully save the Attendee record. Previously, when a Mobile Check-in app user without read permissions for the Invoice and Lead objects tried to change an Attendee’s email address, they saw the following error. “FATAL_ERROR | System.QueryException: Insufficient permissions: secure query included inaccessible field"
Event Groups: Newly created Events will be assigned to the default Event Group. Previously, new Events were not assigned to the default Event Group if one existed. (Known Issue: 000004514)
Event Builder: Event Organizers can successfully edit an existing Event with registered Attendees using the Event Builder. Previously, the Event Builder became unresponsive if the Event had registered Attendees and the Session Settings Use Lightning Web Security for Lightning web components and Aura components setting was disabled (unchecked). (Known Issue: 000004344)
Email Templates
When an Event Organizer saves an Email Template created in the Event Builder, the Email Template will be saved as expected. Previously, the Email Template was saved, but an error also occurred.
When an Event Organizer edits an Event’s Email Template from the Email Template Builder in the Event Builder and saves the edits, they will be returned to the Event they just edited. Previously, if they edited one Event and its Email Template and then a second Event and its Email Template, they were redirected to the first Event after saving the second Event’s Email Template. (Known Issue: 000003373)
Form Elements
When an Attendee searches for a Form Big List Option value with any number of words, the search filter works as expected. Previously, searching for values with three or more words caused the filter to fail. (Known Issue: 000003587)
When an Event Organizer creates a new or deletes an existing Form Element, saves the changes, and makes additional changes, they will see the Forms Preview automatically update with the latest changes. Previously, the user had to perform a page refresh to see the updates in the “New Form Element” modal.
Forms and Mapping
If a Form that maps Form Submission Answers to fields on an Attendee record is added to the Event’s Form (Post-Registration) field and an Attendee completes the Form during registration, the answers will be mapped to the correct fields on the Attendee record. Previously, the answers were not mapped, and there was a mapping error on the Form Submission Answer record. (Known Issue: 000003599)
When an Attendee uploads a file to answer a pre-registration question (Form Element Type = “File Upload”) that is mapped to an image field on the Attendee record, the uploaded file will be stored in Salesforce Files and mapped to the field on the Attendee record. Previously, a BT Log was generated with the “Attempt to de-reference a null object" error, and the file wasn’t uploaded to the correct location. (Known Issue: 000004444)
Enhancements
Recurring Events: Creating Recurring Events by clicking the Create Recurring Event button on the original Event record will also clone the Smart Scheduler scheduled emails (Schedule and Schedule Action records) created from the master template.
Scheduled Jobs: The Blackthorn | Events Attendee Webinar Registration batch job will no longer run when the Schedule Recommended Events Jobs job runs (every hour). The logic contained in the batch job has been placed in other locations, reducing the use of resources.
When users view the Zoom registration page for an Event or a Session, they will see the current number of registrants.
When a new Attendee registers for the Session or Event, the registrant count will update accordingly.
Add to Calendar Feature: The new Enable Add Sessions to Calendar field on the Event Settings object controls whether Attendees can add Sessions as individual calendar entries to their preferred calendar. Please Note: This field belongs to an upcoming feature and is not functional.
Field Label: Enable Add Sessions to Calendar
API Name: conference360__ Enable_Add_Sessions_to_Calendar__c
Data Type: Checkbox
Description: Enables the ability to add individual Sessions as calendar entries when using the Add to Calendar functionality.
Help Text: Enable this setting to allow event registrants to add individual Sessions as calendar entries when using the Add to Calendar functionality.
Event Builder
The field sets listed below were updated to include the following fields in each field set’s “Available Fields” section. Event Organizers can now add these fields to the Event Wizard/Event Builder page layouts.
Blackthorn | V2 Event Wizard Event Details Section (Blackthorn | Event Builder Event Details Section)
Free (Event.Free__c)
Post Registration (Event.After_Submission__c)
Redirect URL (Event.Registration_Redirect_URL__c)
Registration Success Message (Event.Success_Message__c)
Automated Email From Address (Event.Automated_Email_From_Address__c)
Confirmation Email (Event.Confirmation_Email__c)
Waitlisted Email (Event.Waitlisted_Email__c)
Waitlisted Pending Email (Event.Waitlisted_Pending_Email__c)
Blackthorn | V2 Event Wizard Organizer Section (Blackthorn | Event Builder Organizer Section)
Organizer (Contact) (Event.Organizer_Contact__c)
Blackthorn | Event Builder Session Fields
Description (Session.Description__c)
Blackthorn | V2 Event Wizard Virtual Section (Blackthorn | Event Builder Virtual Section)
Zoom Registration Approval Type (Event.Zoom_Registration_Approval_Type__c)
Include Zoom URL In Calendar Description (Event.Include_Zoom_URL_In_Calendar_Description__c)
Zoom Email Notifications (Event.Zoom_Email_Notifications__c)
Zoom Personal Meeting ID Enabled (Event.Zoom_Personal_Meeting_ID_Enabled__c)
Webinar/Meeting ID (Event.Webinar_ID__c)
The Event Builder’s FAQ section now includes an Enable Rich Text toggle. Event Organizers can use the toggle to switch between regular text and rich text when entering an Answer in the Event Builder.
The Email section of the Event Builder now includes additional guidance, including updated help text and visual cues, to help Event Organizers use the component.
When editing an existing Question in the Event Builder’s FAQ section, the Event Organizer will only see the question they are editing. The existing question list and the “create a new question” component will be hidden. Once the Event Organizer clicks Save or cancels the edit, they will see the list of existing questions and the “create a new question” component.
Event Organizers can now add an Event FAQ Category from within the Event Builder.
If the Category field is populated, the question will be listed under that expandable category.
If the Category field is blank, the question will be listed with the uncategorized questions.
Webapp Release
(Release Date: March 18, 2025)
Bug Fixes
Translations: Attendees will see the Speakers tab on the Event webpage translated to Dutch when an Event with the Tabbed UI has an Event Settings record with Source Language = “Dutch” and Target Language = “English.” Previously, everything but the Speakers tab was translated into Dutch. (Known Issue: 000003491)
Experience Cloud: An Experience Cloud user who has already registered for an Event cannot use the Add Myself button to register for the Event a second time. When using the Tabbed or Dynamic UI, the Add Myself button will be disabled after the first registration. Previously, users could click the Add Myself button and try to register a second time. (Known Issue: 000003442)
Data Dictionary: If an Event using the Data Dictionary has a Data Dictionary Entry with the Key set to “MSG_ATTLINK_CONFIRM_REGISTERED” and text in the Value field, then an Attendee will see the full text from the Value field when they click their AttendeeLink. Previously, the last character in the Value field’s text was deleted. (Known Issue: 000004403)
Forms: When an Event Item has a Form with a required multi-select picklist question (Form Element), Attendees must answer the question to continue the checkout process. Previously, removing a different Ticket from the cart allowed Attendees to complete their registration without answering the required multi-select picklist question.
Event Records
Clicking the Update button on a published Event record will populate both the Last Publish To Platform Completed At and Last Publish To Platform Requested At fields. Previously, the Event’s Last Publish To Platform Completed At field was not populated after the Event Organizer clicked the Update button. (Known Issue: 000003686)
Events with the UI Experience set to “Dynamic” will now show the Event's Venue City, Venue State/Province, and Venue Country. Previously, Attendees only saw the Venue City and Venue State/Province, which caused confusion since there are multiple states with cities of the same name.
If an Event uses a post-registration Redirect URL with the Dynamic UI and a “re-direct checkout” platform such as Stripe Checkout, TouchNet, or Transact (CashNet), the Attendee will be directed to the correct URL after they complete the registration process. Previously, the Attendee was directed to the registration success page instead of the Redirect URL.
Registration Experience
When an Attendee registers for an Event, they can navigate back and forth between pages without encountering a blank screen. Previously, when an Attendee clicked Next, then clicked Back to revisit the Ticket selection page, and clicked Next again, they were taken to a blank screen. (Known Issue: 000003418)
Removing a Ticket from the Summary screen by clicking the “X” returns the Attendee to the Ticket Quantity Selection page instead of showing a blank screen.
Enhancements
Event Images: If an Event has the UI Experience set to “Dynamic” and an Event Organizer enters a value in an Event’s Thumbnail and Mobile Image URL image field, Attendees will see the image when using a mobile browser. If the Event’s Thumbnail and Mobile Image URL field is blank, Attendees will see the banner image in the Event’s Image URL field.
Checkout Process: If an Event registrant misses a required field on the Contact or Payment Info forms or enters incorrect data, they will see an error summary at the top of the page. The error summary will include links that direct the individual’s focus to the field(s) with the errors. Screen readers can also access and read the error summary, improving accessibility.
reCAPTCHA: If a free Event has the Event Settings Remove Info Page for Free Events and Enable Captcha fields enabled, Attendees will see the reCAPTCHA on the last page of the registration process.
Search an Event: If the Event Settings Search Bar field is set to “On,” Attendees can search the Event for related information using the following search criteria.
Sponsors: Display Name
Speakers: First Name and Last Name
Attendees: First Name, Last Name, and Title
Sessions: Session Name
Event FAQ:
existing questions: Question in simple or richTextQuestion form and Answer in simple or richTextAnswer form
new questions: Question in simpleTextQuestion form and Answer in simpleTextAnswer form
FAQ Component
When an Event’s UI Experience is set to “Dynamic” and an Attendee reads the FAQ section on an Event’s webpage, they will see an Expand All/Collapse All button. Clicking the button will expand or collapse all the FAQ questions with a single click.
The user interface for the FAQ component was updated to improve accessibility and the visual structure of the questions.
The Event FAQ’s Question field now uses a simple text format to ensure it is displayed correctly.
The Event FAQ’s Answer field is still a rich text field.
The Frequently Asked Questions section of an Event's website will respect the branding (colors, font, etc.) set in the Event Settings record.
Event FAQ questions with a blank Category field (uncategorized questions) will be grouped in their own section without a section title.
Event FAQ questions with a value in the Category field will have the Category as the section title instead of “Expand [Category] Questions.“
When an Attendee toggles open an individual question, the answer will be visible. However, Attendees will no longer see all the questions and answers when they open a section.
Field/Layout Updates
New
Object: Event Registration Submission
Field Label: Primary Email
API Name: conference360__Primary_Email__c
Data Type: Email
Help Text/Description: “The main email from the event registration. This field is automatically populated.”
Object: Event Settings (This field belongs to an upcoming feature and is not functional.)
Field Label: Enable Add Sessions to Calendar
API Name: conference360__ Enable_Add_Sessions_to_Calendar__c
Data Type: Checkbox
Description: Enables the ability to add individual Sessions as calendar entries when using the Add to Calendar functionality.
Help Text: Enable this setting to allow event registrants to add individual Sessions as calendar entries when using the Add to Calendar functionality.
Upgrade Instructions
Go to the Blackthorn Candy Shop to upgrade Events to the newest version.
Blackthorn has adopted Salesforce’s managed package installer to simplify the installation process. The installer will confirm that the correct Base Package and Payments versions are installed before upgrading Events.
For step-by-step instructions, click here.
Important Definitions
Breaking Change
A breaking change is a significant change that requires a package upgrade to see the update.
Off-Cycle or Hotfix Release
A hotfix is a release that corrects a problem that impacted extensive functionality.
BT Salesforce Release
The following applies to a Salesforce release.
Salesforce fixes REQUIRE a package upgrade to see and utilize the fixes/enhancements.
Only users with a System Administrator profile or the ModifyAllData system permission can install packages.
Webapp Release
The following applies to a Webapp Release (previously referred to as a platform release).
Webapp fixes/changes usually do not require updates to the Salesforce package.
These updates automatically apply to all customers; you cannot opt-out.
If you have any questions or need help with testing, please contact Blackthorn Support.