Creating Adobe Commerce (previously Magento 2) transactional templates is now a quick, simple and intuitive process that utilises Dotdigital's EasyEditor.
Before you start
Things you need to know:
Transactional email templates are supported only by Adobe Commerce v2.2.0 and above, and Dotdigital for Adobe Commerce v2.4.4 and above.
Transactional email templates must first be created in EasyEditor as triggered email campaigns.
Learn how to create a triggered campaign in Create a triggered campaign.
Transactional email triggers
These emails are not triggered out of Dotdigital directly. Instead, the source of the campaign is synchronised back to Adobe Commerce every six hours once mapped through the connector.
After synchronisation is complete the campaigns become available under Transactional Templates within Adobe Commerce and replace the default templates that were selected previously.
Read more about Dotdigital's transactional email service in Using transactional email.
Map transactional email templates
Go to Stores > Configuration > DOTDIGITAL > Transactional Email and find the heading Email Templates.
Expand the drop-down menu of the Adobe Commerce email template you want to map your transactional email template to, and choose your triggered email campaign.
Select Save Config, to save your mappings and force your template synchronisation to run.
Template synchronisation normally runs every 6 hours. It can also be run manually by going to Stores > Configuration > DOTDIGITAL > Developer and finding the heading Sync Settings.
Template synchronisation
When you synchronise your transactional email templates the following happens:
In Marketing > Email Templates, a new email template is created for the template which was mapped to in step 2.
the Dotdigital campaign's content is copied into the new email template.
the Dotdigital campaign's subject line is copied into the new email template's subject.
the Dotdigital campaign's From address and Friendly from name are copied to the correct location in your Adobe Commerce account.
Use Adobe Commerce variables
You can make use of any official Adobe Commerce variables in your campaign, provided they're placed inside Liquid raw tags within a text box building block. This makes sure the variables are not misinterpreted as Liquid when the campaign is compiled and therefore format correctly in Adobe Commerce.
Learn more about variables and Liquid templates in Email Templates, and Liquid.
Email subject line
If you're entering tags into the email subject line, you must remove any raw tags, as the variable works without them.
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 %}
Learn more about what variables you can use with your transactional email templates in Use variables in Adobe Commerce transactional email templates.
Restrictions
Email templates sent using a Dotdigital campaign don't support the following EasyEditor features, building blocks and link types:
Personalisation
Product recommendations
Emojis
RSS feed
Sharing
Social links
Dynamic content
External dynamic content
Advanced personalisation blocks
Forward to a friend link
Unsubscribe link (but you must include one in order to save your template in EasyEditor.
Learn more in Create, design, and send a transactional email template.
View in browser link
Double opt-in link
Don't use these types of features, blocks or links in your transactional email template, otherwise your email won't render correctly.