Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Lightning Email Templates entry
How-to guide

How to set up Lightning Email Templates in Salesforce

Lightning Email Templates are the modern email-template system — records (not Setup metadata), share-able like any record, used by Lightning Email Composer in the Activity tab. They replaced Classic Email Templates for most modern email workflows but the two still coexist.

By Dipojjal Chakrabarti · Editor, Salesforce DictionaryLast updated Apr 20, 2026

Lightning Email Templates are the modern email-template system — records (not Setup metadata), share-able like any record, used by Lightning Email Composer in the Activity tab. They replaced Classic Email Templates for most modern email workflows but the two still coexist.

  1. Open the Email Templates tab

    App Launcher → Email Templates. (Lightning Email Templates are stored as records, distinct from Setup-managed Classic templates.)

  2. Click New Email Template

    Top-right.

  3. Set Name and Related Entity Type

    Related Entity Type drives which merge fields are available — Contact / Lead / Opportunity / etc.

  4. Set Subject

    Use merge fields with triple-brace syntax: {{{Recipient.FirstName}}}.

  5. Compose the Body

    Rich text editor with HTML support. Insert merge fields via the picker.

  6. (Optional) Add Letterhead and Folder

    Letterhead applies branding (logo, footer). Folder controls who can see the template.

  7. Save

    Template is created. It's a record — sharable via folders / records / public link.

  8. Use from the Lightning Email Composer

    On any record, open the Activity composer → Email → Insert Template → pick this template.

Key options
Related Entity Typeremember

Which object's fields are mergeable. Account / Contact / Lead / Opportunity / etc.

Letterheadremember

Optional brand wrapper — header logo, footer disclaimer.

Folderremember

Where the template lives. Folder permissions gate access.

Lightning vs Classic Templatesremember

Different objects, different syntax — Lightning uses {{{...}}}, Classic uses {!...}.

Gotchas
  • Lightning Email Templates use Handlebars-style merge fields ({{{Recipient.Name}}}). Classic templates use Visualforce-style ({!Contact.Name}). Don't copy-paste between them.
  • Lightning templates only work in the Lightning Email Composer. They don't show up in Apex SingleEmailMessage by default — those need Classic templates.
  • Folders gate visibility but not edit permission. Anyone with Read on the folder can see; edit requires the user to own the template or have admin access.

See the full Lightning Email Templates entry

Lightning Email Templates includes the definition, worked example, deep dive, related terms, and a quiz.