How to Create Lightning Email Templates in Salesforce using the Email Template Builder?

Article Written By:
Sajiv Narayanan
Created On:

February 14, 2026

Salesforce Email Template Builder canvas showing drag-and-drop components used to create a Lightning email template

To create a Lightning email template in Salesforce, enable Lightning Email Templates in Setup, assign the Access Drag-and-Drop Content Builder permission, then open App Launcher > Email Templates > New Email Template. Save the record, click Edit in Builder, and design the email with drag-and-drop rows, images, buttons, and merge fields. You get a branded, responsive template you can reuse in manual sends, list email, Flow, Email Alerts, and Apex.

Below is the full walkthrough. The setup that unblocks the Builder, each build step, merge field syntax, the limits Salesforce documents, and what to do when the Edit in Builder button never shows up.

What Are Lightning Email Templates?

Lightning email templates are reusable, branded emails you design and store inside Lightning Experience. They support merge fields, attachments, list email, and Apex. One template can serve a rep, a Flow, and a batch job.

The Email Template Builder is the drag-and-drop editor that creates them. You add headers, columns, images, and buttons on a canvas, and Salesforce writes the responsive HTML for you. For a wider view of how admins use them day to day, this guide to Lightning email templates is a useful companion read.

How Lightning Templates Compare With Salesforce's Other Template Types

Salesforce still ships several template types, and the names overlap. Here is the short version.

  • Text - plain text, no formatting, fastest to write.
  • Custom HTML - you paste and maintain the markup yourself.
  • Letterhead - the Classic-era branding wrapper.
  • Visualforce - developer-built, for complex logic.
  • Lightning (Email Template Builder) - visual, responsive, no code.

If you are starting fresh, build in the Email Template Builder. The other types mostly exist for legacy orgs.

Before You Start: Editions, Permissions, and Folder Sharing

Three checks save hours of guessing. Get them right and the Builder simply works.

The Email Template Builder runs in Professional, Enterprise, Unlimited, Performance, and Developer Editions, in Lightning Experience. Turn on enhanced folder sharing for email templates so folders can be shared with roles, groups, and territories. Then grant the drag-and-drop permission.

Permission hygiene is where template rollouts usually stall. Clean profiles, permission sets, and folder access are part of steady day-to-day Salesforce administration, not a one-time task.

How to Create a Lightning Email Template in Salesforce, Step by Step

Six steps take you from a blank org to a tested template. Use the table as your map, then follow the detail below it.

Step Where You Do It What Happens
1. Enable feature and permission Setup, Permission Sets Turn on Lightning Email Templates, folder sharing, and Access Drag-and-Drop Content Builder
2. Create the shell App Launcher, Email Templates Set name, folder, subject, and Related Entity Type; leave HTML Value blank
3. Open the Builder The saved template record Click Edit in Builder to load the canvas
4. Build the layout Builder canvas Drag rows first, then images, rich text, and buttons
5. Personalize Rich Text component and subject line Insert merge fields and set fallback values
6. Preview and test A live Contact or Lead Check desktop and mobile rendering, then send a real test

Step 1. Turn On the Feature and the Permission

In Setup, use Quick Find to open Lightning Email Templates and enable it, along with folder sharing. Then create a permission set, switch on Access Drag-and-Drop Content Builder under System Permissions, and assign it to yourself and your users.

If the button still hides, log out and back in. Permission changes sometimes need a fresh session.

Step 2. Create the Template Record (the Shell)

Open the App Launcher, search Email Templates, and click New Email Template. Enter a clear name, pick a folder, add a subject, and set Related Entity Type to Contact, Lead, or whichever object your merge fields need.

Leave the HTML Value field empty. Paste HTML there and Salesforce treats the record as a custom HTML template, which locks the Builder out for good.

Step 3. Open the Email Template Builder

Save the record, then click Edit in Builder. The canvas opens with a component sidebar on the left and a settings panel on the right.

Set the page background, content width, and padding first. Every component you drop in then inherits the same frame. If you want guided practice, the Trailhead modules on email templates walk through the canvas at your own pace.

Step 4. Build the Layout With Components

Drag rows in first, then drop content inside them. These are the components you will reach for most.

Component What It Does Reach For It When
Row and Column Sets the grid your content sits in Always first, before any content
Rich Text Body copy, fonts, links, and merge fields Any personalized paragraph
Image Logos, headers, and footers from Salesforce Files Branding a header or signature
Button A call to action with its own label and URL Booking links and portal logins
Divider A clean visual break between blocks Separating offer from legal text
HTML Custom markup inside one block Tracking pixels and edge-case layouts

Step 5. Personalize With Merge Fields

Click into a Rich Text component and choose the merge field icon. Pick the source — Recipient, Sender, Organization, or the related record — then choose the field, such as First Name. Salesforce inserts a placeholder that resolves per recipient at send time.

The subject line has no picker, so type merge fields there by hand. Always set a fallback value for fields that can be blank, or your email opens with "Hi ," in front of a customer.

Step 6. Preview, Test, and Save

Never ship a template you have not seen rendered. Save in the Builder, preview it against a real record, and switch between the desktop and mobile views.

Finish with a live test. Open a Contact, go to the Email tab in the Activity panel, click Insert Template, and confirm the layout holds and every merge field fills.

Merge Fields: Lightning vs. Classic Syntax

This is where most migrations break. Classic and Lightning use different syntax, so pasted fields fail silently.

Aspect Lightning (Email Template Builder) Salesforce Classic Templates
Design method Drag-and-drop canvas, no code HTML or letterhead editor
Merge field syntax {{{Recipient.FirstName}}} {!Contact.FirstName}
Subject line merge fields Supported, typed manually Supported through the picker
Attachments Supported Limited
Use in Apex and list email Yes Varies by type
Mobile responsiveness Built in, stacks below 320px Hand-coded
Best fit Branded, reusable customer email Legacy orgs and quick internal notes

Lightning templates use triple curly braces. A Classic field such as {!Contact.FirstName} will not resolve inside a Builder template, so rebuild it with the picker rather than pasting it in.

Cross-object merge fields are also limited. If the data sits two objects away, add a formula field on the related record and merge that field instead.

Email Template Builder Limits You Should Plan Around

The Builder trades some control for speed. Salesforce documents the boundaries, and knowing them up front prevents rework.

Area The Limit What To Do Instead
Active content No JavaScript, ActiveX, streaming media, or animated images Link out to a landing page for interactive content
Images SVG is not supported; uploads fail in Source Mode Use PNG or JPG from Salesforce Files
Styling with merge fields The style tag is not supported in rich text holding merge fields Style through the component settings panel
Editor lock-in Once edited in the Builder, a template stays a Builder template Clone before experimenting on a working template
Merge field picker Does not work while editing rich text in Source Mode Exit Source Mode, then insert the field
Recipient fields Some fields resolve for contacts but not users Test each audience separately before rollout

The lock-in point deserves real attention. Clone a proven template before you test an idea on it. Admin-focused resources such as Salesforce Admins track how these behaviors shift from release to release.

Why "Edit in Builder" Isn't Showing

Nine times out of ten, it is permissions. Work down this list before you open a support case.

What You See Likely Cause Fix
No Edit in Builder button at all Missing Access Drag-and-Drop Content Builder permission Add it to a permission set and assign it, then re-login
Button appears but does nothing The HTML Value field was populated on creation Create a new template and leave HTML Value blank
No Email Templates tab in App Launcher Lightning Email Templates not enabled in Setup Enable it, plus enhanced folder sharing
Cannot see a teammate's template Folder is private or not shared Share the folder with the right role, group, or territory
Merge fields render as raw text Classic syntax pasted into a Lightning template Re-insert each field with the merge field picker
Images break for recipients Image not saved as a public content asset Re-add it with Select From Files and save the template


Using Lightning Email Templates in Flow, Email Alerts, and Apex

A template earns its keep when it sends itself. Lightning templates plug into every automation layer on the platform.

In Flow, use the Send Email action and point it at the template. Email Alerts do the same job inside approvals and record-triggered automation. For custom logic, Apex can build a message from the template and swap the recipient or the related record at run time. Wiring templates into those paths is standard work in a Sales Cloud implementation.

Two rules keep this tidy. Use one template per journey stage, and never clone a template just to change a subject line. Set the subject in the automation instead.

Deploying and Governing Templates Across Orgs

Most guides stop at building one template. The harder problem is 200 templates spread across sandboxes and production with no naming standard.

Templates are metadata, so they can ride your deployment pipeline. Retrieve and deploy the EmailTemplate metadata together with the folder that holds it, and check the Salesforce Developers reference for the fields involved. Content assets behind your images have to travel too, or the header breaks in the target org.

Set guardrails early. Use a naming convention that encodes object and purpose, one shared folder tree per team, a review step before any template goes public, and a named owner for retirement. Templates feeding AI-driven personalization need that discipline even more, because one broken merge field scales instantly.

That is the difference between a template library and template sprawl.

Frequently Asked Questions

1. How do I create a Lightning email template in Salesforce?

Enable Lightning Email Templates in Setup, assign the Access Drag-and-Drop Content Builder permission, then create a template from App Launcher > Email Templates. Save it, click Edit in Builder, and design it with drag-and-drop components.

2. Where is the Email Template Builder in Salesforce?

It is not a separate app. Open a Lightning email template record and click Edit in Builder. That button opens the drag-and-drop canvas.

3. Why is my Salesforce Email Template Builder not showing?

The most common cause is a missing Access Drag-and-Drop Content Builder permission. The second is an HTML Value entered when the template was created, which locks the record to the HTML editor.

4. Can I use merge fields in Lightning email templates?

Yes. Lightning templates use triple curly braces, such as {{{Recipient.FirstName}}}, instead of the single-brace syntax Classic uses. Set fallback values for fields that can be blank.

5. Can I use a Lightning email template in Flow?

Yes. A Flow Send Email action can reference a Lightning email template, so the right message goes out automatically when a record changes.

6. What are the different types of Salesforce email templates?

Text, Custom HTML, Letterhead, Visualforce, and Lightning templates built in the Email Template Builder. New builds should use the Builder unless you need Visualforce-level logic.

Make Your Templates Work Like Infrastructure

The Email Template Builder takes you from plain text to branded, reusable email in an afternoon. Set the permissions once, design with components and merge fields, then reuse the template everywhere your automation needs it.

Minuscule Technologies is a Salesforce engineering partner. We design template systems, connect them to Flow and Apex, and keep folders, permissions, and deployments clean so every automated email lands on brand. Talk to us about your org, and we will map the fix.

Contact Us for Free Consultation
Thank you! We will get back in touch with you within 48 hours.
Oops! Something went wrong while submitting the form.

Recent Blogs

Ready to Architect Your Salesforce Success?

You've seen what's possible. Now, let's make it happen for your business. Whether you need an end-to-end Salesforce solution, a complex integration, or ongoing managed services, our team is ready to deliver.

Schedule a Free Strategic Call