Email Templates

An Email Template contains a group of pre-programmed email formats that can be used in different parts of the application when sending an email. Emails can be sent by clicking the Email icon, which is available from various windows in the system.

Users can create their own email templates or use the predefined system templates for sending emails out to customers or to other employees. Using the right template can make the email contain more helpful information in the format that is customized to your preferences.

Each Email Template can contain fixed text and may include dynamic data fields from the application. You can merge data fields within the email template so the data will be populated to the email. Each Email Template can be based on Text format or HTML format.

When sending an email from within CommitCRM, you can choose the email template you wish to use, by clicking the arrow in the Email icon to open the select list. This will let you choose from the available templates for this entity.

You can define an email template for each entity.

The default template is the template that is used when clicking on the email icon. (Note: Clicking the arrow gives you the list of available templates).

File:Commit setup guide email template select.gif

CommitCRM comes with a set of predefined email templates. You can also define your own templates by choosing the Manage Email Templates option.

In the following sections you will find more details regarding creating and using Email Templates:

• Email Templates Types
• [[Email Templates#Creating Email Templates|Creating Email Templates
• [[Email Templates#Email Signature|Email Signature

Email Template Types

ach Email Template applies to a specific entity in the system. When defining a new Email Template, the system lets you add data fields, which are relevant to the specific entity to the template.

For example, when creating an Email Template for Tickets, you can design the email text and layout, and merge Ticket data fields in the template. The system will let you choose the fields from the available fields list for Tickets, and fields of entities which are linked to the Ticket, such as the linked Account.

The following table provides a summary of each Email Template type, when it is used, and the scope of available fields you can choose from for this template.

Email Template Type	Available From	Available Data Fields	Comments
Generic	Account's Web Users Tab Sales Opportunity's tabs: Influencers, Competitors, Team Documents batch email	*Current User (data fields linked to the currently logged-in user)	The Generic template, which is defined as Default will be automatically used from the relevant windows. There is no option to select a Generic template from a list.
Accounts	Account Details Window Account list (selected line)	Account details Current User
Tickets	Ticket Details Window Ticket List (selected line)	Ticket details Linked Asset Linked Contract Linked Account Linked Contact Current User	When using data fields for linked entities, , the fields will contain the data in the email only if there is a selected entity of this type. Note: When using the Commit Email Connector, it is recommended to include the Ticket Number data field in the email Subject. This will allow the system to file these emails if the customer replies to them and they arrive at the Email Connector.
Assets	Asset Details Window Asset list (selected asset)	Asset details Linked Vendor Linked Account Linked Contact Current User	When using data fields for linked entities, the fields will contain the data in the email only if there is a selected entity of this type.
Sales Opportunities	Opportunity Details Window Opportunity list (selected line)	Opportunity details Linked Account Linked Contact Current User	When using data fields for linked entities, the fields will contain the data in the email only if there is a selected entity of this type.
Calendar (Appointments and Tasks)	Task/Appointment Details Window Calendar list (selected line)	Task/Appointment details Linked Account Linked Contact Linked Ticket Linked Opportunity Linked Contract Current User	Tasks and Appointments can be linked to only one of the following: Opportunity, Ticket, Contract or Asset. When using data fields for linked entities, the fields will contain the data in the email only if there is a selected entity of this type.
Knowledge Base Articles	Knowledge Base Article Details Window Knowledge Base List (selected Article)	Article details Current User
Documents	Document Details Window Document list (selected ticket)	Document details Linked Account Linked Contact Linked Ticket Linked Opportunity Linked Contract Linked Asset Linked Article Current User	Documents can only be linked to one of the following: Opportunity, Ticket, Contract, Asset or Article. When using data fields for linked entities, only if there is actually a selected entity of this type, the fields will contain the data in the email.
Messages	Message Details Window Messages list (selected line)	Document details Linked Account Linked Contact Linked Document Linked Ticket Linked Opportunity Linked Contract Linked Asset Current User	Messages can be linked to one of the following only: Opportunity, Ticket, Contract or Asset. When using data fields for linked entities, , the fields will contain the data in the email only if there is a selected entity of this type.
History Notes	History Note Details Window History Window (selected line)	Document details Linked Account Linked Contact Linked Document Linked Ticket Linked Opportunity Linked Contract Linked Asset Current User	History Notes can only be linked to one of the following: Opportunity, Ticket, Contract or Asset. When using data fields for linked entities, , the fields will contain the data in the email only if there is a selected entity of this type.
None	New Message Window New History Note Window Contacting Support		In these windows, no template will be used when sending an email, as there are no entities involved in the email

Creating Email Templates

To create a new Email Template, from the main menu, go to Settings and select the “Email Templates” option. This opens the Email Templates management window, where you can see a list of Email Templates.

To create a new template, click New at the top left-hand corner of this window. A menu appears, letting you choose from the available Email Templates type.

File:Commit setup guide email template new type.gif

Select the type, and the New Email Template window appears

File:Commit setup guide email template new contents.zoom87.png

This window contains two tabs: Email Content and Details.

In the Contents tab you can define the template itself, including the following fields:

1. Subject
   Here you determine the way the email subject will look. You can include data fields, which will be merged from the real data when creating a real email from this template.
2. Contents
   Here you determine the way the email body will look. You can include data fields, which will be merged from the real data when creating a real email from this template.
3. Email Format
   Select whether the email contents is in Text or HTML format. Note that when selecting HTML format, this means you actually need to enter real HTML code in the contents field.
4. Add Data Fields
   One of the most powerful features of the Email Template is the ability to merge fields from within the database automatically to the email. The email Subject and Contents may include data fields from the entity for which you create the email. Use the Add Data Field button to select the field and to automatically add it in the correct format within the subject or the contents.
   Each email may contain a signature. In order to include the signature in the templates you must add it explicitly as a data field--which is part of the template. The signature should be added from the Current User > Signature field.

When using a Text template, the system will use a text signature. When using an HTML template the system will automatically use the HTML signature defined for the user. See more details in Email Signature.

1. Send Test Email
   Use this button to create a test email and see what the email will look like when used with data from a real entity.

For example, this is how an plain-text designed Ticket template can look like:

File:Commit setup guide email template contents full.gif

In the Details tab, you can set the template name, and determine whether it is active (i.e. will appear in selection lists when choosing a template).

File:Commit setup guide email template new details.gif

Default Template

For each entity type, you can determine a default template. This template will be the template automatically used when clicking the Email icon for the entity (without choosing a template from the list with the arrow).

File:Commit setup guide email template default use.zoom91.png

To set a template as the Default Email Template, right-click the template in the list, and select the Set as Default option.

File:Commit setup guide email template default.gif

After setting an Email Template as default, it will show the Default indication in the templates list.

Only one template of each type can be the default template at a certain time, so setting a template as default will switch an existing default template.