--- title: "Initial Setup" slug: "initial-setup" updated: 2026-10-20T19:30:16Z published: 2026-10-20T19:30:16Z canonical: "docs.blackthorn.io/initial-setup" --- > ## 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. # Initial Setup 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](https://candyshop.blackthorn.io/products/blackthorn-events/latest). ## 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](https://www.loom.com/share/a74b6dc37ead4916bbe7d6e01cc645a1) ## 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](https://docs.blackthorn.io/docs/en/building-your-events).