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:managepermission. - 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
- Open Settings > Features > Notifications.
- Open Templates.
- Use category badges to filter the list, or leave All Templates selected.
- Select the template card.
- Use the full-screen visual editor to change the email.
- Update the subject if needed.
- Add content blocks such as headings, lists, buttons, or images.
- Insert variables when the email needs recipient or workflow data.
- 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-previewYou need notifications:manage to access this page. The page shows Email
Preview & Testing and a Test mode only status.
To preview an email:
- Open the email preview route.
- Choose a Notification Workflow.
- Review the sample payload.
- Select Preview.
- Review the email preview pane.
To send a test email:
- Enter a Test Email Address.
- Choose the workflow.
- 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.
- Open Templates.
- Select a custom template.
- Choose the reset action.
- 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
Confirm you saved the template in the full-screen editor. Then use Email Preview & Testing to preview or send a test email for the workflow.
Confirm you selected the correct workflow template before editing. Reset only when you are sure the custom version should be removed.
Use a verified test account in production. The preview page is intended for testing output before real workflow emails are sent.