Built LMS Help Center
Settings

Customize Workflow Email Templates

Edit, preview, test, and reset automated workflow email templates.

Use Templates when the message is sent automatically by a Built LMS workflow, such as account, enrollment, completion, assessment, certificate, live learning, report, community, manager, credential, or webhook-health events.

Before you begin

You need:

  • The notifications:manage permission.
  • The workflow template you want to update.
  • The intended subject and message changes.
  • A test email address when sending a test message.
  • Confirmation that the change is safe for every workflow email that uses the template.

Your organization logo and the unsubscribe footer are added automatically when emails are sent.

Customize a template

  1. Open Settings > Features > Notifications.
  2. Open Templates.
  3. Use category badges to filter the list, or leave All Templates selected.
  4. Select the template card.
  5. Use the full-screen visual editor to change the email.
  6. Update the subject if needed.
  7. Add content blocks such as headings, lists, buttons, or images.
  8. Insert variables when the email needs recipient or workflow data.
  9. Save the template.

Template categories include:

  • Account.
  • Enrollment.
  • Progress.
  • Reminders.
  • Assessment.
  • Achievements.
  • Live Learning.
  • Administrative.
  • Reports.
  • Community.
  • Manager.

The visual editor supports dynamic variables such as:

{{ recipient.name }}

Preview and send test emails

Use the email preview route to test workflow email output:

/admin-dashboard/notifications/email-preview

You need notifications:manage to access this page. The page shows Email Preview & Testing and a Test mode only status.

To preview an email:

  1. Open the email preview route.
  2. Choose a Notification Workflow.
  3. Review the sample payload.
  4. Select Preview.
  5. Review the email preview pane.

To send a test email:

  1. Enter a Test Email Address.
  2. Choose the workflow.
  3. Select Send Test Email.

Supported workflow examples include course enrolled, exam submitted, certificate issued, learning path milestone, password reset, account welcome, group assignment, course reminder, and system announcement.

In production, send test emails only to verified test accounts.

Reset a template to default

Use reset when a custom template should return to the system default.

  1. Open Templates.
  2. Select a custom template.
  3. Choose the reset action.
  4. Confirm Reset Template to Default.

Resetting deletes the custom template for that workflow and cannot be undone.

Verify success

The template change is ready when:

  • The preview shows the expected subject, body, logo, variables, and footer.
  • A test email reaches the intended test address.
  • The workflow still reads correctly with sample data.
  • The template list shows the expected custom or default status.

Troubleshooting

On this page