Transactional email templates

Please note

Transactional email templates are only supported by dotmailer for Magento v2.2.0 and above.

Summary

You have the ability to replace default transactional email templates from Magento and use dotmailer campaigns instead.

For more information and guidance about dotmailer's transactional email service, read Using transactional email.

Steps to replace default email templates with dotmailer campaigns

  1. Click on Email Templates from under 'DOTMAILER'
    mag2_email_templates.png
  2. For the appropriate Magento email template, select a dotmailer campaign from the dropdown next to it (a triggered campaign type is recommended but you can select from any)
    mag2_select_campaign_for_default_template.png
  3. Click Save Config

This will automatically cause your template synchronisation to run (it normally runs every 6 hours and can be run manually by going to Developer > Sync Settings), which will do the following:

  • in MARKETING > Email Templates (under the 'Communications' section), a new email template will be created for the template which was mapped to in step 2
    mag2_marketing_email_templates_created.png
  • the dotmailer campaign's content will be copied into the new email template 
  • the dotmailer campaign's subject line will be copied into the new email template's subject
  • the dotmailer campaign's 'From address' and 'Friendly from name' will be copied to the correct location in Magento admin

Using Magento variables

You can make use of any official Magento variables in your campaign, provided they're placed inside Liquid raw tags. This makes sure the variables aren't misinterpreted as Liquid when the campaign is compiled.

Here are some examples:

Gets the customer's first name

{% raw %} {{var customer.firstname}} {% endraw %}

Gets the payment method used

{% raw %} {{var paymentMethod}} {% endraw %}

Gets the first line of the shipping address

{% raw %} {{var order.getShippingAddress().getStreet1()}} {% endraw %}
Read more about Magento variables and customising email content »

Restrictions

Email templates sent using a dotmailer campaign don't support the following EasyEditor features, building blocks and link types:

  • personalisation
  • 'RSS feed'
  • 'Sharing'
  • 'Social links'
  • 'Dynamic content' (this includes classic dynamic content)
  • 'External dynamic content'
  • 'Advanced personalisation' blocks
  • 'Forward to a friend' link
  • 'Unsubscribe' link (but you will need to include one in order to save your template in EasyEditor; see 'About unsubscribe links' below)
  • 'View in browser' link
  • 'Double opt-in' link

Don't make use of these types of features, blocks or links in your transactional email template, otherwise your email won't render correctly.

Have more questions? Submit a request

Comments