Transactional Emails

7 Minutes to read

Print
Share
Dark
Light

Transactional Emails

7 Minutes to read

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

General Information

For transactional emails, you can either use the default Adobe Commerce emails or choose a prepared message from the integrated Mapp Engage system.

Mapp Connect does not support order state updates in the transactional Related Data table. To use order states in the message sendout, prepare an email message template that uses the state value email parameter. For more information, see Mapp Engage Functions.

Procedure

Go to Stores > Mapp Connect > Messages to see a list of all Adobe Commerce transactional emails.
In the General section, enable emails via Mapp.
For each Email message that you want to send from Mapp Engage, uncheck the Use system value checkbox. If checked, this will override the settings for this message and send the Adobe Commerce Default message.
Select an Email Template for each event. Examples:
1. Sends prepared email messages from Engage:
2. Sends default messages from Adobe Commerce:
Click Save Config.

Placeholders

Below are the placeholders for creating Mapp Engage email templates (Prepared Messages).

Placeholders for email templates

New Order

sales_email_order_template

In <%/ForEach%> loop:

timestamp
currency
productSKU
productName
productPrice
productQuantity
imageURL
productURL
category

New Order for Guest

sales_email_order_guest_template

• parameter.billing_address
• parameter.email_order_note
• parameter.guest_customer_name
• parameter.order_created_at_datetime
• parameter.order_id
• parameter.order_items_grid
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_message

In <%/ForEach%> loop:

timestamp
currency
productSKU
productName
productPrice
productQuantity
imageURL
productURL
category

Order Update

sales_email_order_comment_template

• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status

Order Update for Guest

sales_email_order_comment_guest_template

• parameter.guest_customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status

New Invoice

sales_email_invoice_template

• parameter.billing_address
• parameter.customer_account_url
• parameter.customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.invoice_items_grid
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description

New Invoice for Guest

sales_email_invoice_guest_template

• parameter.billing_address
• parameter.guest_customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.invoice_items_grid
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description

sales_email_invoice_comment_template
• parameter.customer_account_url
• parameter.customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.order_id
• parameter.order_status

Invoice Update

sales_email_invoice_comment_template

• parameter.guest_customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.order_id
• parameter.order_status

sales_email_shipment_comment_template

• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
• parameter.shipment_id

Invoice Update Guest

sales_email_invoice_comment_guest_template

• parameter.guest_customer_name
• parameter.invoice_comment
• parameter.invoice_id
• parameter.order_id
• parameter.order_status

sales_email_shipment_comment_template

• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
• parameter.shipment_id

Shipment Update (for Guest)

sales_email_shipment_comment_guest_template

• parameter.guest_customer_name
• parameter.order_comment
• parameter.order_id
• parameter.order_status
• parameter.shipment_id

New Credit Memo

sales_email_creditmemo_template

• parameter.billing_address
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.credit_memo_items_grid
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description

New Credit Memo for Guest

sales_email_creditmemo_guest_template

• parameter.billing_address
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.credit_memo_items_grid
• parameter.guest_customer_name_billing
• parameter.order_id
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_description

Credit Memo Update

sales_email_creditmemo_comment_template

• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_id
• parameter.order_status

Credit Memo Update for Guest

sales_email_creditmemo_comment_guest_template

• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.guest_customer_name
• parameter.order_id
• parameter.order_status

New Account

customer_create_account_email_template

• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name

New Account Without Password

customer_create_account_email_no_password_template

• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name

New Account Confirmation Key

customer_create_account_email_confirmation_template

• parameter.account_confirmation_url
• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name

New Account Confirmed

customer_create_account_email_confirmed_template

• parameter.customer_account_url
• parameter.customer_email
• parameter.customer_name

Reset Password

customer_password_forgot_email_template

• parameter.customer_name
• parameter.reset_password_url

Remind Password

customer_password_remind_email_template

• parameter.customer_account_url
• parameter.customer_name

Change Email

customer_account_information_change_email_template

• parameter.product_name
• parameter.recipient_email_address
• parameter.recipient_name
• parameter.sender_custom_message
• parameter.sender_email
• parameter.sender_name
• parameter.url_for_product
• parameter.url_for_product_small_image_75_px

Change Email and Password

customer_account_information_change_email_and_password_template

Send Product Link to Friend

sendfriend_email_template

Price Alert

catalog_productalert_email_price_template

• parameter.alert_data_grid
• parameter.customer_name
• parameter.email_footer_template
• parameter.email_header_template

Stock Alert

catalog_productalert_email_stock_template

• parameter.alert_data_grid
• parameter.customer_name
• parameter.email_footer_template
• parameter.email_header_template

Wishlist

wishlist_email_email_template

• parameter.customer_name
• parameter.view_wish_list_url
• parameter.wish_list_items
• parameter.wish_list_message

Unique List

Parameters

• parameter.billing_address
• parameter.email_order_note
• parameter.order_id
• parameter.order_items_grid
• parameter.payment_details
• parameter.shipping_address
• parameter.shipping_description
• parameter.shipping_message
• parameter.guest_customer_name
• parameter.order_created_at_datetime
• parameter.customer_account_url
• parameter.customer_name
• parameter.order_comment
• parameter.order_status
• parameter.invoice_comment
• parameter.invoice_id
• parameter.invoice_items_grid
• parameter.shipment_id
• parameter.credit_memo_comment
• parameter.credit_memo_id
• parameter.credit_memo_items_grid
• parameter.guest_customer_name_billing
• parameter.customer_email
• parameter.account_confirmation_url
• parameter.reset_password_url
• parameter.product_name
• parameter.recipient_email_address
• parameter.recipient_name
• parameter.sender_custom_message
• parameter.sender_email
• parameter.sender_name
• parameter.url_for_product
• parameter.url_for_product_small_image_75_px
• parameter.alert_data_grid
• parameter.email_footer_template
• parameter.email_header_template
• parameter.view_wish_list_url
• parameter.wish_list_items
• parameter.wish_list_message

Email Example

Order Confirmation Email Template

<html>
  
<body>
  <p>Dear
    <%parameter.firstname%>
      <%parameter.lastname%>
  </p>
  <p> Thank you for shopping , please see your order no. <%parameter.orderId%> details below: </p>
  <br>
  <%InsertIf expression="${not empty parameter['orderNote']}" id="0"%>
    <h3>Order notes:</h3>
    <p>
      <%parameter.orderNote%>
    </p>
    <%/InsertIf%>
  
      <table class="order-details">
        <tr>
          <td class="address-details">
            <h3>Billing Info</h3>
            <p>
              <%parameter.billingAddress%>
            </p>
          </td>
          <td class="address-details">
            <h3>Shipping Info</h3>
            <p>
              <%parameter.shippingAddress%>
            </p>
          </td>
        </tr>
        <tr>
          <td class="method-info">
            <h3>Payment Method</h3>
            <p>
              <%parameter.paymentInfo%>
            </p>
          </td>
          <td class="method-info">
            <h3>Shipping Method</h3>
            <p>
              <%parameter.shippingMethod%>
            </p>
  
            <%InsertIf expression="${not empty parameter['shippingMessage']}" id="1"%>
              <h3>Shipping message:</h3>
              <p>
                <%parameter.shippingMessage%>
              </p>
              <%/InsertIf%>
          </td>
        </tr>
      </table>
  
      <%ForEach var="product" items="${transaction_details}"%>
        <table width="100%" cellpadding="0" cellspacing="0" border="0" >
          <tr>
            <td align="top" >
              <table width="100%" cellpadding="0" cellspacing="0" border="0" >
                <tr>
                  <td align="center" class="someCSSSstyle">
                    <a href="<%${product['productURL']}%>" >
              <img src="<%${product['imageURL']}%>" width="280" border="0"  /></a>
                  </td>
                </tr>
                <tr>
                  <td >
                    <table width="100%" cellpadding="0" cellspacing="0" border="0" >
                      <tr>
                        <td align="center" >
                          <a href="url" target="_blank" >
                           
                          <%${product['brand']}%>
                           
                           </a>
                        </td>
                      </tr>
                      <tr>
                        <td align="center" >
                          <a href="url" target="_blank" >
                           
                          <%${product['productName']}%>
                           
                           </a>
                        </td>
                      </tr>
                      <tr>
                        <td align="center" >
                          <a href="url" target="_blank" >
                           
                          Quantity: <%${product['productQuantity']}%>, Price per item: <%${product['productPrice']}%> <%${product['currency']}%>
                           
                           </a>
                        </td>
                      </tr>
                    </table>
                  </td>
                </tr>
              </table>
            </td>
          </tr>
        </table>
        <%/ForEach%>
  
          <table class="order-details">
            <tr>
              <td class="address-details">
                <h3>Shiping Price:</h3>
                <p>
                  <%parameter.shippingTotal%>
                </p>
              </td>
              <td class="address-details">
                <h3>Order items total:</h3>
                <p>
                  <%parameter.orderItemsTotal%>
                </p>
              </td>
            </tr>
          </table>
  
          <br>
          <h2> TOTAL:
            <%parameter.orderTotal%>
              <%${product['currency']}%>
          </h2>
          <br>
  
          <p>Greetings!</p>
</body>
  
</html>

Transactional Emails

General Information

Procedure

Placeholders

Placeholders for email templates

Unique List

Email Example

Related Topics

What's Next