Email Templates
Edit database-stored Markdown email templates with merge fields and version history.
Overview
Email Templates lists system and custom templates. Each template has a Markdown body, subject line, merge fields, and version snapshots.
Where it lives
Routes:
- List:
/admin/settings/email-templates - Edit:
/admin/settings/email-templates/{template}/edit
Open Admin → Preferences → Email Templates.
Key workflows
| Action | Behaviour |
|---|---|
| Edit | Change title and Markdown body |
| Preview | Sample-data render in an iframe |
| Reset | System templates only — restore seeded default |
| Send Test | Pick template + recipient from the list page |
| Email Layout | Pick the branded chrome this template renders inside |
Merge fields use {{ field.path }} with optional filters (| upper, | default:"N/A"). Every save snapshots the previous version.
Email layout
The edit form carries an Email Layout picker listing every active layout. The first option — Default — {layout name} — leaves email_templates.email_layout_id null, so the template follows whichever layout is currently the default (the seeded Signals master layout on a fresh install). Pick a specific layout to pin this one template to different chrome.
The preview renders through the selected layout, so switching the picker re-renders the sample immediately. If the chosen layout is later deactivated or deleted, the template silently falls back to the default layout and then to the built-in Blade layout — mail never fails because of a layout change.
See Email Layouts for the layout dialect and editor.