--- title: "E-mail Templates" slug: "email-templates" description: "Create tailored email templates for document handling, enhancing communication across Sales, Purchase, and Warehouse with dynamic fields and custom signatures." updated: 2026-05-05T05:55:19Z published: 2026-05-05T05:55:31Z canonical: "docs.abakion.com/email-templates" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.abakion.com/llms.txt > Use this file to discover all available pages before exploring further. # E-mail Templates ## Feature Overview Email Templates are the foundation of Document Handling. They define the content of every email sent through the app — including the subject line, body text, signature, and which dynamic data fields to include from the underlying document. Templates are organised by department type (Sales, Purchase, Warehouse), document type (e.g. Sales Order, Sales Invoice), and mail type (New, Change, Accept, Reject, Cancel, Reminder, Overdue), so each document scenario can have its own tailored message. A template consists of a header record (the **Document Handling Text**) and a rich body. The header controls the subject line, which document fields to include in the subject (order number, external order number, line number), the mail type category, the language, and signature settings. The body is either composed as free-form HTML using the Dynamic Email Fields feature, or as plain text built from text lines. Templates can be copied from one document type to another, saving setup time when documents share similar content. Templates are linked to document types through **Document Handling E-mail Templates** (the sending profile). Each row in that list ties a department type and document type to a specific template, and additionally controls whether the email preview dialog is shown before sending, what Cc and Bcc addresses to use, and how attachments are handled. This separation means the same template can be reused across multiple document types, while sending behaviour is configured per document type. **Key Facts** | Topic | Detail | | --- | --- | | Where to create templates | Document Handling Text (accessed via Document Handling E-mail Templates → Template Card) | | Where to assign templates to document types | Document Handling E-mail Templates | | Supported department types | Sales, Purchase, Warehouse | | Supported document types | Sales Quote, Sales Order, Sales Invoice, Sales Cr. Memo, Sales Blanket Order, Sales Shipment, Purchase Quote, Purchase Order, Purchase Invoice, Purchase Cr. Memo, Purchase Blanket Order, Reminder, Fin. Charge Memo, Customer Statement, Pro Forma Sales Invoice | | Supported mail types | New, Change, Accept, Reject, Cancel, Reminder (1–3), Overdue (1–3) | | Language support | One template per language code; default language set in Document Handling Setup | | Dynamic fields feature | Optional — enable via Abakion Feature Management ("Dynamic Email Fields") | --- ## Getting Started 1. Open **Document Handling Setup** and set the **Default Language** to your primary language code (e.g. ENU). 2. Run **Default Setup** in Document Handling Setup to generate the default template records, status values, and sending profile rows. This creates a starting set you can customise. 3. Open **Document Handling E-mail Templates** to see all sending profile rows — one per department/document type combination. 4. Select a row for the document type you want to configure (e.g. Sales Invoice) and open **Template Card** from the action bar. 5. On the template card, set the subject line. If **Dynamic Email Fields** is enabled, the subject is an inline field inside the editor — type `{` to open the field picker dropdown and select a placeholder, or type static text. If Dynamic Email Fields is not enabled, use the **Subject Text** field and enable **Include Order Number** to append the document number automatically. 6. If the **Dynamic Email Fields** feature is enabled (Abakion Feature Management), write your email body in the **Email Body Content** editor. Type `{` anywhere in the body to open a searchable dropdown of all available fields grouped by source table (Document, Customer/Vendor, Company, Signature) — select a field to insert it as a styled pill. Alternatively, use the **Field Picker** side panel on the right to browse all available fields and double-click to insert at the cursor position. 7. If Dynamic Email Fields is not enabled, go to the **Text Lines** subpage and enter your body text as plain text lines. Lines with fewer than 50 characters or ending in `.` or `?` are automatically followed by a line break. 8. Set up the **signature** fields (Include Name, Include Title, Include Phone, Include Mail) and optionally enable an HTML signature on the **Signature** tab. 9. Return to **Document Handling E-mail Templates** and confirm the **Document Template** column points to your template. Set **Don't show E-mail Preview Dialog** if you want silent sending. 10. Test by opening a Sales Invoice and using the **Send** action — the email dialog should appear pre-filled with your template content. --- ## Related Features Email Templates work closely with all other features in Document Handling. **Email Signatures** are configured directly on each template record and can use either plain text or HTML. **Document Handling Users** provides the salesperson or purchaser data that populates the `{SignatureName}`, `{SignatureTitle}`, `{SignaturePhone}`, and `{SignatureEmail}` placeholders at send time. **Email Sending & Sending Profiles** links templates to document types and controls silent sending, Cc/Bcc, and Post and Send behaviour. **Attachments** are enabled per sending profile row and control whether files from the source document or Master Data Information are appended to the email. **Our Status & Vendor/Customer Status** interacts with templates by driving which mail type (e.g. New, Change, Cancel) is selected when a purchase line action triggers a send. --- ## User Stories ****US-01: Create a sales invoice email template with a personalised subject line**** **As a** Business Manager **I want to** create a dedicated email template for Sales Invoices that includes the invoice number in the subject **So that** recipients can immediately identify which invoice the email refers to **Setup:** 1. Open **Document Handling E-mail Templates**. 2. Find or create the row for Department Type = **Sales**, Document Header Type = **Sales Invoice**. 3. Click **Template Card** to open the template. 4. In **Subject Text**, enter your base subject, e.g. `Invoice from Contoso`. 5. Enable **Include Order Number** and optionally fill in **Order Number Text** (e.g. `No.`) to prefix the document number. 6. Save the template. > **Note:** The document number is appended automatically at send time — you do not need to type a placeholder in the subject field. ****US-02: Write a plain-text email body for a sales order confirmation**** **As a** Business Manager **I want to** write a standard body text for sales order confirmation emails **So that** every order confirmation sent to a customer follows a consistent format **Setup:** 1. Open **Document Handling E-mail Templates** and locate the Sales Order row. 2. Click **Template Card**. 3. Navigate to the **Text Lines** subpage (visible when Dynamic Email Fields is not enabled). 4. Add lines with your message text. Blank lines generate `<br>` line breaks in the email. Lines under 50 characters or ending in `.` or `?` are automatically followed by a line break. 5. Save and send a test document to verify the output. ****US-03: Write an HTML email body using Dynamic Email Fields and the Field Picker**** **As a** IT Manager **I want to** enable the Dynamic Email Fields feature and use the enhanced template editor to build HTML email bodies with dynamic placeholders **So that** outgoing emails automatically include document-specific data without having to memorise or type placeholder names manually **Setup:** 1. Open **Abakion Feature Management** and enable **Dynamic Email Fields**. Confirm the migration prompt — existing text lines are automatically converted. 2. Open **Document Handling E-mail Templates** and click **Template Card** for the relevant document type. 3. In the **Email Body Content** editor, insert dynamic fields using either of two methods: - **`{` triggered dropdown** — type `{` anywhere in the body. A searchable dropdown opens immediately, showing all available fields grouped by source table (Document, Customer/Vendor, Company, Signature). Type to filter, use arrow keys to navigate, and press Enter or click to insert the field as a styled mention pill. - **Field Picker side panel** — click the panel icon on the right side of the editor to open a persistent panel listing all available fields in collapsible groups. Search across all groups, then double-click any field to insert it at the current cursor position. 4. For repeating line data, type `[Line:` followed by the line-level field pills you need (e.g. `[Line:{Line.Description} {Line.Quantity}]`). The block is repeated once per document line at send time. 5. The subject line is embedded in the same editor and supports the same `{` triggered dropdown — insert dynamic fields into the subject using the same method. 6. Save and use the **Send** action on a document to preview the resolved output. > **Note:** Available fields are determined by the **Department Type** of the template (Sales, Purchase, or Warehouse) — the field picker shows only fields relevant to the document context. ****US-04: Create separate templates for different mail type scenarios (New, Change, Cancel)**** **As a** Business Manager **I want to** set up different email templates for new orders, change requests, and cancellations **So that** the tone and content of each email matches the business situation **Setup:** 1. In **Document Handling Text** (accessible from the template card lookup), create three separate template records for the same department type, each with a distinct **Text Code** (e.g. `PO-NEW`, `PO-CHANGE`, `PO-CANCEL`). 2. Set the **Mail Type** on each record accordingly: New, Change, Cancel. 3. Open the advanced **Document Handling Text Setup** page. 4. For the Purchase Order row, assign each template to the corresponding default field: **Default New Document**, **Default Change Document**, **Default Cancel Document**. ****US-05: Copy an existing template to a new document type**** **As a** Business Manager **I want to** copy a template from Sales Invoice to Sales Credit Memo without retyping everything **So that** related document types share a common base and I only need to adjust the differences **Setup:** 1. Open **Document Handling Text** and find the template you want to copy from. 2. Use the **Copy From** action to select the source template. The header fields and text lines are transferred. 3. The Department Type, Text Code, Language Code, and Mail Type of the target record are preserved — only the content is overwritten. 4. Edit the copied content as needed for the new document type. ****US-06: Set up multilingual templates for international customers**** **As a** Business Manager **I want to** configure email templates in both English and Danish **So that** customers receive emails in their own language when the document language matches **Setup:** 1. In **Document Handling Text**, create two template records with the same **Text Code** and **Department Type** but different **Language Code** values (e.g. ENU and DAN). 2. Write the body content of each in the appropriate language. 3. In **Document Handling Setup**, set the **Default Language** to the language code used when no document-level language is found. 4. At send time, Document Handling matches the language code of the document to the available templates and selects the correct one. ****US-07: Configure reminder templates for purchase order follow-up (Reminder 1, 2, 3)**** **As a** Purchasing Agent **I want to** configure three escalating reminder templates for unanswered purchase order requests **So that** each follow-up email has an appropriately firmer tone **Setup:** 1. Create three template records with Mail Type = **Reminder** and **Reminder No.** set to 1, 2, and 3 respectively. 2. Write escalating body text for each. Reminder No. cannot exceed 3. 3. In **Document Handling Text Setup**, assign each template to the **Default Handling Reminder 1**, **Default Handling Reminder 2**, and **Default Handling Reminder 3** fields on the Purchase Order row. 4. Similarly, configure **Overdue** templates (Overdue 1–3) for payment-related escalations. ****US-08: Include order line details in a purchase order email (quantity, item, dates)**** **As a** Purchasing Agent **I want to** include line-level data such as item number, quantity, and delivery date in outgoing purchase order emails **So that** the vendor immediately knows what is being requested without having to open an attachment **Setup:** 1. Open the template card for the Purchase Order document type. 2. Enable the relevant **Include** checkboxes: **Include Item Number**, **Include Quantity**, **Include Our Ramp Date**, **Include Cust or Vendor Ramp Date**, etc. 3. For each enabled field, optionally enter a label in the corresponding **Text** field (e.g. "Qty:" next to Include Quantity) to prefix the value in the email. 4. If using Dynamic Email Fields, use `[Line:{Line.Item No.} {Line.Quantity}]` syntax to repeat line data in the HTML body. ****US-09: Configure a customer statement email template**** **As a** Accountant **I want to** configure an email template specifically for Customer Statements **So that** the email subject and body include the customer name and statement period **Setup:** 1. In **Document Handling E-mail Templates**, locate or create the row for Document Header Type = **C.Statement**. 2. Open the **Template Card**. 3. Enable **Include Order Number** to include the customer number in the subject. The subject is automatically extended with `{Customer.Name}` and the statement period dates (`{StartDate}...{EndDate}`). 4. Write the body text or HTML content as appropriate. ****US-10: Run the default setup to generate starter templates**** **As a** IT Manager **I want to** run the default setup wizard to generate a full set of starter templates, status values, and sending profiles **So that** the app is ready to use without having to create every record from scratch **Setup:** 1. Open **Document Handling Setup**. 2. Click the **Default Setup** action. 3. If templates already exist, you are asked whether to delete them or allow modifications to duplicates. Choose **No** / **Yes** as appropriate for your situation. 4. After the setup runs, open **Document Handling E-mail Templates** to review the generated sending profile rows, and open individual templates to customise the content. > **Note:** The default setup also creates the standard Our Status and Customer/Vendor Status values, and adds a Document Handling Users entry for the current user. ****US-11: Include the customer's or vendor's external order number in the subject**** **As a** Sales Order Processor **I want to** include the customer's own order reference number in the email subject **So that** the customer can immediately match the email to their internal order **Setup:** 1. Open the template card for the relevant document type. 2. Enable **Include Customer or Vendor Order No**. 3. Optionally enter a label in **Cust or Vendor Order No Text** (e.g. "Your ref:"). 4. The customer's external document number is appended to the subject at send time. ****US-12: Configure a Pro Forma Sales Invoice email template**** **As a** Sales Order Processor **I want to** have a dedicated email template for Pro Forma Sales Invoices **So that** the email clearly indicates the document is a pro forma and not a binding invoice **Setup:** 1. In **Document Handling E-mail Templates**, locate the row for Document Header Type = **Pro Forma S. Invoice**. 2. Open the **Template Card** and write body content that references the pro forma nature of the document. 3. Assign a suitable subject such as `Pro Forma Invoice`. 4. Enable the Pro Forma invoice email scenario — the app subscribes to the BC `OnAfterFromReportSelectionUsage` event to route this document type to the correct email scenario. --- ## Field Reference | Field | Where to find it | What it does | Default | | --- | --- | --- | --- | | Text Code | Document Handling Text | Unique identifier for the template | — | | Language Code | Document Handling Text | Language this template applies to | — | | Mail Type | Document Handling Text | Scenario category: New, Change, Accept, Reject, Cancel, Reminder, Overdue | New | | Department Type | Document Handling Text | Sales, Purchase, or Warehouse | — | | Subject Text | Document Handling Text | Static portion of the email subject line | Blank | | Include Order Number | Document Handling Text | Appends the document number to the subject | Off | | Order Number Text | Document Handling Text | Label prefix before the document number in the subject | Blank | | Include Customer or Vendor Order No | Document Handling Text | Appends the external order number to the subject | Off | | Include Order Line Number | Document Handling Text | Appends the line number to the subject | Off | | Reminder No. | Document Handling Text | Which reminder step (1, 2, or 3) this template is for | Blank | | Email Body Content | Document Handling Text | HTML/text body (used when Dynamic Email Fields is enabled) | Blank | | Enable Html Signature | Document Handling Text | Activates the HTML signature for this template | Off | | Document Template | Document Handling E-mail Templates | The template assigned to this document type / sending profile row | — | | Don't show E-mail Preview Dialog | Document Handling E-mail Templates | Sends the email without showing the preview dialog | Off | | Cc e-mail | Document Handling E-mail Templates | Fixed Cc address for this document type | Blank | | Bcc e-mail | Document Handling E-mail Templates | Fixed Bcc address for this document type | Blank |