---
title: "Email Template Builder"
slug: "email-template-builder"
tags: ["Events"]
updated: 2026-09-09T19:41:20Z
published: 2026-09-09T19:41:20Z
canonical: "docs.blackthorn.io/email-template-builder"
---

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

# Email Template Builder

Create beautiful reminders and post-Event emails in Salesforce with a no-code editor (no need to create an email using HMTL/CSS).

[Embedded content](https://www.youtube.com/embed/Joe18THkRvE)

## Before You Start

### Configure the UID

The Email Settings’ Custom Setting **Custom Email Builder UID Handler** field gives you more control when setting UID for special use cases.

The **Custom Email Builder UID Handler** field defines a custom handler. Use the following format to configure the new field as "TestUIDHandler."

```java
1 public class TestUIDHandler implements EmailEditorUIDInterface{
2           public String getUID(){
3                   return '1234567890';
4           }
5}
```

### Update the Event Object’s Page Layout

Add the "Email Templates" Related List to the Event object’s page layout.

1. Go to Setup.
2. Click the Object Manager tab.
3. In the Quick Find box, enter and click “Event” (conference360__Event__c).
4. Click the Page Layouts tab and click the layout you want to update.
5. Click the Related Lists tab.
6. Locate “Email Templates” and drag and drop it on the page layout.
7. Click **Save**.

### Check Permission Sets

Confirm that you have the correct permissions. When you save a template, the Email Template Builder creates a Classic email template and stores it in the shared **Blackthorn_Events** email folder, so it is available to reuse across your events.

**Permission Sets**

- Blackthorn | Events (Admin) or Blackthorn | Events (Organizer)
- Blackthorn | Payments (Admin)

**System Permissions**

The Email Template Builder does **not** require **Author Apex**, **Customize Application**, or **Modify Metadata Through Metadata API Functions**. Saving a template creates an ordinary email template record: it does not compile Apex and it does not deploy metadata. If your team was granted these permissions only in order to use the Email Template Builder, you can remove them.

Customize Application is a wide-ranging permission, so confirm the change in a sandbox before you apply it in production.

What users do need is permission to **create Classic email templates in a shared folder**. Without it, saving a template fails with an insufficient privileges error even though every other permission above is in place.

**For Salesforce admins:** saving a template writes an `EmailTemplate` record into the `Blackthorn_Events` email folder, and a Blackthorn Email Template record that stores the design. Both are standard record saves. Access to the builder itself comes from the Blackthorn | Events permission set listed above.

If you are running into insufficient privileges, please watch this troubleshooting video.

[Embedded content](https://www.loom.com/embed/2ebc825d6c4f46b5b195cb1baad5afe2)

### Create Out-of-the-Box Email Templates

1. Navigate to the Blackthorn | Events Admin tab.
2. Click the Configuration tab.
3. Click **Create Email Templates**. Here is a [quick video](https://www.loom.com/share/2da10406fb6b4e6896b207cc64044849) on how to create templates!

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

### Flows and Email Templates

Using Email Templates and flows (previously workflows) together can create problems.

For example, if an Attendee’s **Registration Status** is set to “To Invite” and an Email Template email is sent, the **Registration Status** field automatically updates to “Invited.”

If you intend to use this feature, we recommend disabling the “Send Blackthorn | Event invite email” flow.

## Instructions

### Functionality Update

The Email Template builder functionality no longer avoids MSO code. You can now import Classic Email Templates into Blackthorn Events.

### Start Here

Setting up your first template is simple!

1. Navigate to an Event record. New Email Templates can only be created from the Email Template Builder component in an Event record.
2. On the "Email Templates" related list, click the dropdown arrow and click "New". ![template builder 2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%202.png)
3. On the "New Template" modal, select "New" and click **Continue**. **Note:** The "New From Template" option will create a new template from an existing template.
4. *(Optional)*: If you want to check out a template, we have included 12 by default.
  - Standard Template | Invite Light
  - Standard Template | Confirmation Light
  - Standard Template | Reminder Light
  - Standard Template | Missed You Light
  - Standard Template | Cancelled Light
  - Standard Template | Thank You Light
  - Standard Template | Invite Dark
  - Standard Template | Confirmation Dark
  - Standard Template | Reminder Dark
  - Standard Template | Missed You Dark
  - Standard Template | Cancelled Dark
  - Standard Template | Thank You Dark

If you create a new Email Template from an existing record, you'll notice the **Event Name** displayed under the **Email Template Name**. This will help when deciding which Email Template to use when cloning your new record.

If you do not see an **Event Name** under the **Email Template Name** name that means an Event has not been associated with the Email Template yet.

**NOTE:** When saving the Email Template, the **Email Template Name** length must be 80 characters or less, including the developer’s name (the unique date/time that is added to the end of the email template API name).

![template builder 3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%203(1).png)

1. Next, you'll see a page similar to the one below. The "Blackthorn University" image is pulled directly from the **Image URL** field on your Event. ![template builder 4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%204(1).png)
2. To add an image, drag and drop the Image tile from the Content section into the template.
3. Click "Browse" and you'll be presented with the File Manager. ![template builder 5](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%205(1).png)
4. Use the Upload, Import, or Search free photos options to add images.
  - Use the Upload button to add an image locally from your computer.
  - Use the Import button to add an image via Facebook, Dropbox, One Drive, etc. ![template builder 6](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%206.png)
  - To upload an image via Salesforce Files, copy the public link from your image into the "Just provide the link" box. ![template builder 7](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%207(1).png)
5. To add merge fields, click on a text box, click "Merge Tags", and select the tag you want! Below is an example of some tags that could be used to display the event name, date, and time! **Note:** When adding in dates and times, please use the **Event Start Date**/**Event Start Time** and **Event End Date**/**Event End Time** to avoid issues with daylight savings time. ![template builder 8](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%208(1).png)

1. When saving the Email Template, you can insert merge tags into the subject line as well. An example would be: "You're invited to {{{!conference360__Attendee__c.conference360__Event_Name__c}}}!"

It's free rein from here. Play around and see what you can build.

### Edit Your Images

You can also edit your image in the Email Template, with one exception. Adding rounded corners to images does not work with JPG files; it only works with PNG files.

Complete the following steps to round the corners of a PNG image file.

1. Open an existing Event record.
2. Scroll down to the Email Templates Related List.
3. Click an existing Email Template. If you need to create a new Email Template, click **New** and follow the [instructions](/v1/docs/email-template-builder#instructions) listed above.
4. Click an existing image or add a new content row and upload a PNG image file.
5. Click **Apply effects**.

![Email%20Template_Curve%20Image%20Corners_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Email%20Template_Curve%20Image%20Corners_1.png)
6. Click the **Corners** icon.

![Email%20Template%20Corners_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Email%20Template%20Corners_2.png)
7. Drag the Radius slider to the right until the corners are the correct shape.

![Email%20Template%20Corners_3](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Email%20Template%20Corners_3.png)
8. Click **Apply**. (If the image is a JPG file, the empty corner spaces will be filled with a black background.)
9. Click **Save**. The image's corners are now rounded.

![Email%20Template%20Corners_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Email%20Template%20Corners_4.png)
10. Once you are done editing the Email Template, click **Save**.
11. Confirm the **Subject** and click **Save**.

## Send Emails

You can send emails from several places. If you don't see the following buttons on your Event page layout, please add them.

### Sending an Email Can Change the Registration Status

When an Attendee’s **Registration Status** is **To Invite**, sending them an email updates it to **Invited**. This happens whether you send from the Event record, from the Attendee record using **Send Email Immediately**, or with the **Send Invite** button on the Event record.

Only **To Invite** is affected. Any other **Registration Status** is left unchanged, and the status is never changed back.

- Event Record
  - Click the **Send Email** button on an Event record to send an email to all Attendees specified in the criteria for the Event.
- Attendee Record
  - Click the **Send Email** button on an Attendee record to send an email directly to that Attendee, and only that Attendee.

**Note:** It may take several minutes for the Email Template to appear in the Related List.

### Experience Cloud Prerequisites

When logged in to the Experience Cloud as a Community user, you can preview and send emails from an Attendee or Event object after performing the following steps:

- Add a Sharing Setting to the Attendee object: Set the **Default External Access** field to “Public Read/Write” (Location: Setup > Settings > Security > Share Settings).
- Create a CSP Trusted Site: Set the **Trusted Site URL** field set to “https://*.cloudfront.net" (Location: Setup > Settings > Security > CSP Trusted Sites > New Trusted Site).

### From the Event Record

Select one of the following methods to send an email from an Event.

- The **Send Emails From** address will determine which email address the Email Template is being sent from. By default, this is the Current User (the Salesforce user currently logged in.) Emails will be automatically added to this picklist by adding them to the Organization-Wide Email Addresses in Salesforce Setup.
- The **Email Template** field is where you can select which Email Template to send.
- The **Attendee Filter** field controls which Attendees receive the email. This can be filtered by any selection within the **Registration Status** field (Invited, Registered, etc.) or the **Attendance Status** field (Attended, No Show, etc.). ![template builder 9](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%209(1).png)

### From the Attendee Record

Select one of the following methods to send an email from an individual Attendee.

- The **Send Emails From** address is who the email comes from. By default, this is the Current User (the Salesforce user currently logged in). Emails will be automatically added to this picklist by adding the email to the Organization-Wide Email Addresses in Salesforce Setup.
- The **Email Template** field is where you can select which Email Template to send. ![template builder 10](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/template%20builder%2010(1).png)

## Edit Your Email Template

1. Open the Event record with the related Email Template.
2. Go to the related Email Template list and click **New**.
3. Select “New From Template.”
4. Choose an Email Template.
5. Click **Continue**.
6. Click the Row tab.
7. In the template, select the row that you want to change the background color.
8. Enter a hex # in the Row background color field.

![Edit%20Email%20Template](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Edit%20Email%20Template.png)
9. Click **Save**.
10. Enter an **Email Template Name** and **Subject** if you want to rename the template.
11. Click **Save**.

## View Previously Created Email Templates

To see the templates created with the Blackthorn Email Template Builder, you need to add the Blackthorn Custom Email Template object as a tab in your org. Complete the steps below to add a new tab to your app picker.

1. Click the **Gear** icon.
2. Click **Setup**.
3. In the Quick Find box, search for and click “Tabs”.
4. Click **New**.
5. Set **Object** to “Email Template”.
6. Select a **Tab Style**.
7. Click **Next**.
8. Choose the visibility requirements for the tab.
9. Click **Next**.
10. Choose the custom apps where the new tab will be visible.
11. Click **Save**.

The steps above will then add the Blackthorn Custom Email Template tab to your available app navigation items.

***Recommendation:*** We suggest renaming this tab as it has the same name as the Salesforce Standard Email Template folder.

## FAQ

### “Refused to Connect” Error

Q: I received a “refused to connect” error (i.e., '[domain.csxyz.visual.force.com](http://domain.csxyz.visual.force.com) refused to connect') when creating an Email Template through the Builder. What do I do?

A: If you receive a refused to connect error (i.e., '[domain.csxyz.visual.force.com](http://domain.csxyz.visual.force.com) refused to connect') when creating an Email Template through the Builder, you must allowlist several domains in Salesforce.

To allowlist the following three domains for Visualforce Pages, go to Setup > Session Settings.

- [lightning.force.com](http://lightning.force.com) ([http://lightning.force.com/](http://lightning.force.com/))
- [my.salesforce.com](http://my.salesforce.com) ([http://my.salesforce.com/](http://my.salesforce.com/))
- Your "My Domain" (for example, [https://blackthorn--full.lightning.force.com](https://blackthorn--full.lightning.force.com))

### Links Not Working

Q: My Attendees have reported that links in Yahoo are not showing up as hyperlinks, how do I fix this?

A: Yahoo Mail does not automatically convert hyperlinks, unlike Google Mail, for example. To hyperlink merge fields, text, etc., please use the Link feature built into the Email Template Builder.

### Add a Merge Field to a Button

Q: Can I insert a merge field behind a button?

A: Yes, you can. In the following example, we will add the Merge Tag for the AttendeeLink to the **Attend Event** button.

![Add Merge Tag to Button_1](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Add%20Merge%20Tag%20to%20Button_1.png)

1. Open an Email Template.
2. Click in any area with text.
3. Click **Merge tags**.
4. Locate and click “Attendee -> AttendeeLink.”
5. Cut the merge tag and click the area with the **Attend Event** button.
6. Paste the merge tag into the button’s Action **URL** field.

![Add Merge Tag to Button_2](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Add%20Merge%20Tag%20to%20Button_2.png)
7. Click **Save**.
8. Enter a **Subject** and click **Save**.
9. Send the email invitation to your Attendees.

When your Attendees receive the email and click the **Attend Event** button, they will be taken to their AttendeeLink.

![Add Merge Tag to Button_4](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Add%20Merge%20Tag%20to%20Button_4.png)

### Preview Email Does Not Show Images and Icons

Q: Why can’t I see the email images and social icons in the Preview Email in the Email Template Builder?

A: The issue occurs because some external domains used by the Bee/BeeFree email editor are not included in your Salesforce org’s Content Security Policy (CSP) allowlist.

Blackthorn’s Events package does not set CSP headers due to an org-level CSP requirement. Instead, Events relies on the org-level Lightning/VF CSP configuration.

To resolve the issue, add the required Bee/BeeFree domains to the CSP Trusted Sites list.

1. Go to Setup.
2. In the Quick Find box, enter and click “Trusted URLs.”
3. Click **New Trusted URL**.
4. Enter an **API Name**.
5. Enter “[https://d1oco4z2z1fhwp.cloudfront.net”](https://d1oco4z2z1fhwp.cloudfront.net”) in the **URL** field.
6. Update the other settings as needed.
7. Click **Save**.
8. Repeat the process for the remaining three URLs.
  - [https://d15k2d11r6t6rl.cloudfront.net](https://d15k2d11r6t6rl.cloudfront.net)
  - [https://loader.getbee.io](https://loader.getbee.io)
  - [https://app-rsrc.getbee.io](https://app-rsrc.getbee.io)
9. Once you have added all four URLs, perform a hard refresh or re-login to Salesforce.

The Preview Email modal will now display the images and social icons correctly.