---
title: "Use Magento Transactional Emails"
slug: "use-magento-transactional-emails"
updated: 2024-03-18T10:26:36Z
published: 2024-03-18T10:26:36Z
canonical: "docs.mapp.com/use-magento-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.

# Use Magento Transactional Emails

## General Information

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

> Info for Magento 2.4+
> 
> 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 > Mapp Connect > Messages* to see a list of all Magento Transactional emails. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/e5e7d573-58e6-4b9d-b1b6-1abfb0beb331.png)
2. Uncheck the **Use system value** checkbox next to each event (message type) that you want to send from Engage. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/3371b880-20ce-4480-b4cd-ebd48aa0085f.png)
3. Select an Email Template for each event. Example: ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/66b6fdc4-3f6b-4843-9095-0cd19e6af5e1.png)
4. Click **Save Config**.

## Placeholders

Below are the placeholders with which you create 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>
```

## Related Topics

[Prepared Messages](/v1/docs/prepared-messages)