Skip to main content
All CollectionsIntegrationsMagento Open Source and Adobe CommerceTransactional email
Map transactional email templates in Magento Open Source and Adobe Commerce
Map transactional email templates in Magento Open Source and Adobe Commerce

Map your Dotdigital transactional emails to your Adobe Commerce transactional email templates.

Gareth Burroughes avatar
Written by Gareth Burroughes
Updated over a year ago

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

  1. Go to Stores > Configuration > DOTDIGITAL > Transactional Email and find the heading Email Templates.

  2. 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.

  3. 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.

  • 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.

Did this answer your question?