Skip over navigation
Documentation
You are currently viewing documentation for a previously released version of OroCRM. See the latest long-term support version.

Email Templates

With OroCRM you can easily sent numerous personalized emails using one template. For example, you can make a single template that welcomes {username}, assign it to an Email Campaign and each of your subscribers will get a mail send specifically to them.

The articles describes the ways to create and manage Email Template records.

Create Email Templates

  1. Go to System → Emails → Templates page and click Create Template button in the top right corner to get to the “Create Template” form.
email_template_create
  1. Define the general settings of the template:

    The following fields are mandatory and must be defined:

FieldDescription
Template Name*Name used to refer to the template in the system.
Type*Use html or plain text.
Owner*Limits the list of users that can manage the template, subject to the access and permission settings.

Optional field “Entity Name” shall be used to define an entity, variables whereof can be used in the template. If no entity name is defined, only system variables will be available.

Important

If you want to use the template for autoresponses, the “Entity Name” value should be “Email”.

  1. Define the email template. Click on the necessary variable to drag it to the text box.
../../../_images/email_template_ex.png

In the example below, the template contains a link to the website page composed with a piece of tracking code. Every time a user follows the link, visit event will be tracked for the campaign.

  1. You can click Preview button to check your template.
../../../_images/email_template_preview.png

Important

Keep in mind that when editing HTML email templates, you pass them to the WYSIWYG editor. WYSIWYG automatically tries to modify the given HTML template against the HTML specifications. Therefore, the text and tags that violate the HTML specifications should be wrapped up in the HTML comment. For example, there should not be any other tags or text between the <table></table> tags except thead, tbody, tfoot, th, tr, td.

Examples:

Invalid template:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
         <table>
             <thead>
                 <tr>
                     <th><strong>ACME</strong></th>
                 </tr>
             </thead>
             {% for item in collection %}
             <tbody>
                 {% for subItem in item %}
                 <tr>
                     {% if loop.first %}
                     <td>{{ subItem.key }}</td>
                     <td>{{ subItem.value }}</td>
                     {% endif %}
                 </tr>
                 {% endfor %}
             </tbody>
             {% endfor %}
         </table>

Valid template:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
     <table>
         <thead>
             <tr>
                 <th><strong>ACME</strong></th>
             </tr>
         </thead>
         <!--{% for item in collection %}-->
         <tbody>
             <!--{% for subItem in item %}-->
             <tr>
                 <!--{% if loop.first %}-->
                 <td>{{ subItem.key }}</td>
                 <td>{{ subItem.value }}</td>
                 <!--{% endif %}-->
             </tr>
             <!--{% endfor %}-->
         </tbody>
         <!--{% endfor %}-->
     </table>
  1. If you are satisfied with the preview, save the template in the system with the button in the top right corner on the page.

Email Template Languages

If several languages have been enabled for the email templates, move from tab to tab, to define the template in different languages.

../../../_images/email_template_language.png

Manage Email Templates

The following actions are available for an email template from the grid:

../../../_images/email_template_actions.png
  • Delete the template from the system:

  • Get to the Edit form form of the template:

  • Clone the template:

    You can edit the template details and save a new (cloned and edited) template.

Now you can create an Email Campaign, and send personalized emails based on your template to the pre-defined list of subscribers.

Hint

If you want to track the user-activity related to the emails sent within the Email Campaign, add a piece of Tracking Website code to the email template.

Browse maintained versions:2.62.32.01.12
Forums
Back to top