Canvas Manual
Search…
Mail merge terms
How to add mail merge terms to an email template mail merge list and content

Overview

A mail merge term is simply a placeholder text within asterisks (e.g., *FIRSTNAME* ) that is replaced with dynamic content when the email is sent.
You have to remember that adding mail merge terms to the email template mail merge terms list or to the email template content is not enough for them to work, you have to add the logic in the correspondent backend workflow.
If the following sections of this page you are going to learn:

How to add mail merge terms to the email template content

To add mail merge terms to the email template content is as easy as typing them between asterisks (e.g., *FIRSTNAME* ).
But Canvas has now a new system to help you add them without even having to type them.
This method is present in Canvas templates from version [PENDING RELEASE] onwards
Now you can just type an asterisk and Canvas is going to show you all the mail merge terms that have been already added to the email template mail merge list. You just have to click on the desired term and it will be added to the content automatically.
Add mail merge terms to the email content
And don't forget that you still have to add the logic in the backend for this mail merge term to work.
Keep reading to learn how to add mail merge terms to the email template list.

How to add mail merge terms to the email template mail merge terms list

You should add the mail merge terms to this list so you can keep track of the terms you are using in each template and to be able to add them later to the email content in a semi-automatic manner.
There are two methods to add mail merge terms to the email template mail merge terms list:
  1. 1.
    Add them in the EMAIL SETTING tab
  2. 2.
    Add them when editing the email template content (only in Developer mode)

1. Add them in the EMAIL SETTING tab

In the edit email template popup -> EMAIL SETTING tab, click on 'Edit terms'
Edit email template popup
Then, in the Edit mail merge terms popup you can add or delete them. Don't forget to click on Save terms to make the changes permanent.
Edit mail merge terms popup

2. Add them when editing the email template content (only with Developer mode enabled)

This method is enabled only when the Developer mode is on and for Canvas templates from version [PENDING RELEASE] onwards
In the edit email template popup -> EMAIL CONTENT tab:
  1. 1.
    Start by entering content in any of the available inputs: subject, body, button (optional) or signature.
  2. 2.
    When you add a placeholder text within asterisks (e.g., *FIRSTNAME* ) and after you leave the input (e.g., click in another one) Canvas will recognize the new term and will show you the new term/s available to be added to the email template mail merge list
  3. 3.
    Click on the term you want to be added to the list and an alert will confirm that the term has been added to the list
  4. 4.
    Done! This new mail merge term will be available to you to be added to the content when you type '*'.
Add mail merge terms to the list from the content
And don't forget that you still have to add the logic in the backend for this mail merge term to work.