---
title: "Transactional Emails"
slug: "transactional-emails"
updated: 2026-06-04T06:50:17Z
published: 2026-06-04T06:50:17Z
canonical: "docs.mapp.com/transactional-emails"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactional Emails

## 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](/v1/docs/mapp-engage-functions).

## Procedure

1. Go to *Stores > Configuration > Mapp Cloud > Mapp Engage (Connect) - Emails* to see a list of all Adobe Commerce transactional emails. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/fe13307b-e4ec-4850-b877-8718a2329058.png)
2. In the **General** section, enable emails via Mapp.

![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/fb0cf351-40d4-44b5-b262-6b849e9300d8.png)
3. 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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/f38264e6-a6d7-419b-8eb6-9ee29fd41d2f.png)
4. Select an Email Template for each event. Examples:
  1. Sends prepared email messages from Engage: ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/69641b65-6726-430c-8c52-f8890d5e65be.png)
  2. Sends default messages from Adobe Commerce: ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/94939597-bc1f-4036-8267-67a601f6da59.png)
5. Click **Save Config**.

## Placeholders

Below are the placeholders for creating Mapp Engage email templates ([Prepared Messages](/v1/docs/prepared-messages)).

### Placeholders for email templates

**New Order**

**sales_email_order_template**

• 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

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**

• 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

**Send Product Link to Friend**

**sendfriend_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

**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**

```xml
<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>
```