Email Builder
The Email Builder allows administrators to create Jinja-based HTML email templates for distribution. When an email is sent from Docwize, the template is populated with document metadata and other dynamic values from the floating toolbar. Templates can be set as the default for specific action types — for example, transmittal distributions or action requests.
Who configures this
Administrators with access to the New module. The Email Builder is accessible from New > Custom Fields & Configuration > Email Template Builder.
Email Templates
When users navigate to the Email Builder, they see the Email Templates screen listing all existing templates.
Email Template Builder button
Email Templates screen
| Control | Description |
|---|---|
| Search templates | Filters the template list by name. |
| Create New Template | Opens the template editor to create a new template. |
| Template name | The name of the email template. |
| Default for | Shows which action type this template is set as the default for. Displays None if not set as a default. |
| Set No Default (dropdown) | Associates the template with an action type, making it the default email sent for that action. Click to select or change the association. |
| Send (paper plane icon) | Opens the template tester to send a test email. |
Create New Email Template
Clicking Create New Template opens the template editor.
Create New Email Template editor
| Field | Description |
|---|---|
| Template Name | The name of the template. Required. |
| Subject | The email subject line. Recipients see this as the email subject. Jinja references can be included. |
| Action type dropdown | Sets this template as the default for a specific action type (e.g. Action Request, Distribution). |
| Save | Saves the template. |
| Download Filename Builder | Configures the filename structure for documents downloaded from this email. |
| Filename format | Selects the columns used to build the download filename. |
| HTML editor | The template body, written in HTML with Jinja references inserted where dynamic content should appear. |
| Preview panel | Renders a live preview of the email as currently written. |
How to build an email template
| Step | Description |
|---|---|
| 1 | Navigate to New > Custom Fields & Configuration > Email Template Builder. |
| 2 | Click Create New Template and enter a Template Name and Subject. |
| 3 | In the HTML editor, write or paste the email HTML. Insert Jinja references from the floating toolbar where dynamic values should appear. |
| 4 | Optionally set the action type dropdown to make this the default template for a specific action. |
| 5 | Configure Download Filename Builder if a specific filename structure is required for downloaded attachments. |
| 6 | Click Save. |
| 7 | Optional: click the Send (paper plane icon) on the template listing to send a test email and confirm the output is as expected. |
What can go wrong
| Issue | Detail |
|---|---|
| Jinja fields not populating | Confirm that the field references in the template match the available variables. Use the floating toolbar to insert references rather than typing them manually. |
| Template not appearing as the default for an action | Check the Set No Default dropdown on the template and confirm it is set to the correct action type. Only one template can be the default per action type. |
| Recipients receiving the wrong template | Check whether another template is set as the default for the same action type. |
| Preview not matching sent email | Some email clients render HTML differently. The preview is indicative only — test by sending a test email using the Send icon. |
Related configuration
- Floating toolbar — Jinja syntax reference for inserting dynamic values into templates
- Jinja Template Language — overview of Jinja syntax used in email templates