Initial Setup

Prev Next

This page covers what a Salesforce admin sets up before anyone can design pages. When these steps are complete, you can open Page Designer from a Salesforce Event record or from the event's public URL. We recommend completing them in a sandbox first.

1. Install the latest Blackthorn Events release

Install the latest release of Blackthorn Events, or confirm with your admin that it is already installed. Every feature on this page is available in Blackthorn Events 5.61 or later.

You can upgrade from the Candy Shop.

2. Assign permission sets

Assign one of these Blackthorn Events permission sets to each user who will design pages. Each user also needs a Blackthorn Events license.

  • Blackthorn | Events (Admin): full access to Page Designer, including creating, editing, deleting, and assigning layouts.
  • Blackthorn | Events (Organizer): the same Page Designer access as Admin, for any event in the org. Page Designer does not limit organizers to the events they are assigned to.

3. Make sure Page Designer is in the UI Experience picklist

Open an Event record and check the UI Experience field for a Page Designer option. If it is missing, which is common in orgs that upgraded from an older version, an admin can open the Blackthorn Events admin page and click Update Picklists once. This adds any missing values.

You can also add the value manually. You need permission to customize applications (typically System Administrator or equivalent).

  • From Setup, open Object Manager.
  • Select Event (the Blackthorn Events object).
  • Click Fields & Relationships.
  • Click UI Experience.
  • In the Values related list, click New.
  • Enter "Page Designer" as the picklist value label and make sure "Page-Designer" is the API name.
  • Click Save.
  • If your org uses record types on Event, open each relevant record type, edit the UI Experience picklist, and move Page-Designer into Selected Values so users can choose it on Event records.

4. Set up your Event records

Page Designer reads dynamic content from the Event record: name, description, dates, sessions, speakers, tickets, venue, sponsors, and FAQ. The more detail your Event records have, the richer your pages will be.

Set the Event's UI Experience field to Page-Designer before you open Page Designer or publish the event page. If UI Experience is Dynamic, Tabbed, or Simple, Page Designer layouts do not apply and the event keeps its current experience.

5. Add the Page Designer component to the Event record page

The BT Page Designer Lightning component ships with Blackthorn Events but is not on the Event record page by default. You can drop it anywhere on the page, or give it a dedicated tab.

  • On the Event record, click the Setup gear in the page header.
  • Click Edit Page to open Lightning App Builder.
  • Open the Components tab in the left sidebar.
  • Search for BT Page Designer, or find it under Custom - Managed.
  • Drag BT Page Designer onto the page canvas.
  • Select the component and set the height in the properties panel on the right.
  • Click Save.

To give Page Designer its own tab instead:

  • On the Event record, click the Setup gear in the page header.
  • Click Edit Page to open Lightning App Builder.
  • On the page canvas, click the Tabs region to select it.
  • In the properties panel on the right, under Tabs, click Add Tab.
  • Click the new tab item (it defaults to Details). In Tab Label, choose Custom, enter a name such as Page Designer in the Custom Label field, and click Done.
  • Click your new tab in the canvas.
  • Search for BT Page Designer, or find it under Custom - Managed.
  • Drag BT Page Designer onto the page canvas.
  • Select the component and set the height in the properties panel on the right.
  • Click Save.

6. Enable Lightning Web Security in Session Settings

The Full Screen button in Page Designer expands the editor to fill your browser window. Inside Salesforce, it works once Lightning Web Security is turned on for your org. This requires Blackthorn Events 5.61 or later.

  • From Setup, search for Session Settings in Quick Find and open it.
  • Check Use Lightning Web Security for Lightning web components and Aura components.
  • Click Save.
  • Wait a couple of minutes for the change to take effect.
  • Open an Event record that uses the BT Page Designer component and click Full Screen. Page Designer now fills the window.

Note: This is an org-wide setting. It applies to all Lightning web components and Aura components in your org, not only Page Designer. We recommend enabling and testing it in a sandbox first, and checking with your Salesforce admin before turning it on in production.

Watch a short walkthrough (about 1 minute 45 seconds): Enable Full Screen for Page Designer

Open Page Designer

You can open Page Designer in two places.

From the Salesforce Event record

  • Open an Event record with the UI Experience field set to Page-Designer.
  • Go to the BT Page Designer component to choose a template and start editing.
  • Edit the layout or choose a template, then save your changes.
  • Publish the Event in Salesforce so visitors see your updates.

From the event URL

  • Open an Event with the UI Experience field set to Page-Designer.
  • Go to the Event record's Event Page URL.
  • If the event is published and you are signed in, choose Edit event in Page Designer in the bar at the top of the page.
  • If you are not signed in, or the event is not published, change /overview at the end of the URL to /builder and sign in when prompted.
  • Edit the layout or choose a template, then save your changes.
  • Publish the Event in Salesforce so visitors see your updates.

Once those steps are complete, you're ready to build your event.