# Email templates

### Email templates - need to know <a href="#id-9v3uzku85z2t" id="id-9v3uzku85z2t"></a>

{% hint style="info" %}
**Search Variables**? Use Ctrl-F and the field name to quickly locate and review the syntax.
{% endhint %}

Email templates save time and standardize formal communications. You can create and use email templates for sending every document type.

See <mark style="color:orange;">Setup>Email Templates></mark> for a List of templates and their associated Documents.

The quickest way to learn how to create a template is to edit an example from the List.

### Setup Email template <a href="#sc5fzq5pq0l1" id="sc5fzq5pq0l1"></a>

Create a new template for the associated Document

<mark style="color:orange;">Setup>Email Templates>New Template</mark> and choose the Document type.

| Template Name | Free text                               |
| ------------- | --------------------------------------- |
| Description   | Free Text                               |
| From          | A variable i.e. ${company\_from\_email} |
| Reply To      | A variable i.e. ${company\_from\_email} |
| Subject       | Free text, including variables          |
| Copy to       | A variable i.e. ${company\_from\_email} |
| Plain text    | Send as plain text, probably ‘Courier’  |

### Mail merge parameters (variables) <a href="#kkzt67nczp47" id="kkzt67nczp47"></a>

| Parameter name                                                                           | Description                                |
| ---------------------------------------------------------------------------------------- | ------------------------------------------ |
| <h4 id="ehq18fqngvxv">Customers and Suppliers</h4>                                       |                                            |
| ${title}                                                                                 | Main contact title                         |
| ${first\_name}                                                                           | Main contact first name                    |
| ${last\_name}                                                                            | Main contact last name                     |
| ${customer\_login\_id}                                                                   | Login ID for customer portal               |
| ${customer\_password}                                                                    | Login password for customer portal         |
| ${balance}                                                                               | The account balance                        |
| <h4 id="az6f18qxyx2f">Lead</h4>                                                          |                                            |
| ${first\_name}                                                                           | Main contact first name                    |
| ${last\_name}                                                                            | Main contact last name                     |
| <h4 id="id-8uq9j2pll31a">Customer/Supplier Payment</h4>                                  |                                            |
| ${amount\_paid}                                                                          | The amount paid                            |
| ${payment\_date}                                                                         | The payment date                           |
| ${payment\_details}                                                                      | Invoice # and amount paid for each invoice |
| <h4 id="jv5oxr93kcuq">Documents (Sales Orders/Invoices/Bills etc)</h4>                   |                                            |
| ${title}                                                                                 | Customer/Supplier title                    |
| ${full\_name}                                                                            | Customer/Supplier full name                |
| ${first\_name}                                                                           | Customer/Supplier first name               |
| ${last\_name}                                                                            | Customer/Supplier last name                |
| ${due\_date}                                                                             | Due date                                   |
| ${issue\_date}                                                                           | Issue date                                 |
| ${required\_date}                                                                        | Required data                              |
| ${balance}                                                                               | Balance                                    |
| ${total}                                                                                 | Total                                      |
| ${ref\_number}                                                                           | Ref #                                      |
| <h4 id="id-39d2mhugf7tx">Customer Statement</h4>                                         |                                            |
| ${title}                                                                                 | Customer/Supplier title                    |
| ${first\_name}                                                                           | Customer/Supplier first name               |
| ${last\_name}                                                                            | Customer/Supplier last name                |
| ${ref\_number}                                                                           |                                            |
| ${start\_date}                                                                           |                                            |
| ${end\_date}                                                                             |                                            |
| <h4 id="fu0lv93jaap1">Timesheet</h4>                                                     |                                            |
| ${week\_of}                                                                              | Week of date                               |
| <h4 id="y6ptnyfo229r">Company Info (available to all templates)</h4>                     |                                            |
| ${company\_from\_email}                                                                  | Company *from* email                       |
| ${company\_name}                                                                         | Company name                               |
| ${company\_legal\_name}                                                                  | Company legal name                         |
| ${company\_address1}                                                                     | Company address line 1                     |
| ${company\_address2}                                                                     | Company address line 2                     |
| ${company\_county}                                                                       | Company address county                     |
| ${company\_town\_city}                                                                   | Company address town/city                  |
| ${company\_zip\_code}                                                                    | Company address zip/post code              |
| ${company\_state}                                                                        | Company address state                      |
| ${company\_country}                                                                      | Company address country                    |
| ${company\_fax}                                                                          | Company address fax                        |
| ${company\_phone}                                                                        | Company phone number                       |
| ${company\_email}                                                                        | Company email                              |
| ${company\_web}                                                                          | Company website                            |
| ${company\_number}                                                                       | Company number                             |
| <h4 id="v51amew74hn7">Personal (Logged in Worker) Info (available to all templates)</h4> |                                            |
| ${personal\_email}                                                                       | Logged in Worker email                     |
| ${personal\_first\_name}                                                                 | Logged in Worker first name                |
| ${personal\_last\_name}                                                                  | Logged in Worker last name                 |
| ${personal\_job\_title}                                                                  | Logged in job title                        |
| ${personal\_office\_tel}                                                                 | Logged in Worker office telephone          |
| ${personal\_mobile}                                                                      | Logged in Worker mobile number             |
| ${personal\_office}                                                                      | Logged in Worker office name               |
| ${personal\_team}                                                                        | Logged in Worker team name                 |

${@partnerRef} for ‘customer ref’ on docs

${@fieldname} - for any field on doc (found by looking at the source)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpwith.salesorder.com/setup/email-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
