Email templates

Email templates define the layout, content, and formatting of automated messages sent from your store. They are called transactional emails because each one is associated with a specific type of transaction, or event.

Commerce includes a set of responsive email templates that are triggered by various events that take place during the operation of your store. Each template is optimized for any screen size, and can be viewed from the desktop, as well as on tablets and mobile devices. There are various prepared email templates related to customer activities, sales, product alerts, admin actions, and system messages that you can customize to reflect your brand.

Commerce emails can be rendered by HTML and plain text email clients. There might be some variation between clients in the way email are rendered.

Logos can be saved as any of the following file types. Logos with transparent backgrounds can be saved as either .GIF or .PNG files.

  • JPG/JPEG
  • GIF
  • PNG

There are dimensions specified in the header template. However, to ensure that your logo renders well on high-resolution devices, the uploaded image should be three times this size. Typically, original logo artwork is created as a vector image, so it can be scaled up without losing resolution. The image can then be saved in one of the supported bitmap image formats.

To take advantage of the limited vertical space in the header, make sure to crop the image to eliminate any wasted space at the top or bottom. When editing the image, be careful to preserve the aspect ratio of the logo, so the height and width resize proportionally.

As a rule, you can make an image smaller than the original, but not larger without losing resolution. Taking a small image and scaling it up in a photo editor lowers the resolution of the image. For example, if the display dimensions of the logo are 168 pixels wide by 48 pixels high in the header template, the uploaded image should be 504 pixels wide by 144 pixels high.

Logo Dimensions 1 x (display size) 3 x (image size)
Width: 168 px 504 px
Height: 48 px 144 px

Configure email templates

The configuration determines the logo that appears in the default header template, and any custom header and footer templates that you want to use for transactional email messages sent from your stores.

Transactional email design

For a detailed list of the configuration settings, see Transactional Emails in the Content and Design Guide.

  1. On the Admin sidebar, go to Content > Design > Configuration.

  2. Find the store view that you want to configure and click Edit in the Action column.

  3. Under Other Settings, expand Expansion selector the Transactional Emails section.

  4. To upload your prepared Logo Image, click Upload and select the file from your system.

  5. For Logo Image Alt, enter alternate text to identify the image.

  6. Enter the Logo Width and Logo Height in pixels.

    Enter each value as a number, without the px abbreviation. These values refer to the display dimensions of the logo in the header, and not to the actual size of the image.

If you have custom header and footer templates for your store, or for different stores, you can specify which templates are used for each, according to the scope of the configuration. Otherwise, the default templates are used. To learn more, see Customizing Email Templates.

  1. Choose the Header Template to be used for all transactional email messages.

  2. Choose the Footer Template to be used for all transactional email messages.

  3. When complete, click Save Config.

Email template list

The list of email templates is organized alphabetically by module.

Amazon_Payment

Template Configuration path
Hard-declined Authorization n/a
Soft-declined Authorization n/a

Magento_Checkout

Template Configuration path
Payment Failed Page: Sales > Checkout
Section: Payment Failed Emails
Field: Payment Failed Template

Magento_Company

B2B for Adobe Commerce (Available with B2B for Adobe Commerce only)

Template Configuration path
Assign Company Admin Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Assign Company Admin’ Email
Assign Company to Customer Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Assign Company to Customer’ Email
Company Admin Changed to Member Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Company Admin Changed To Member’ Email
Company Admin Set Inactive Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Customer Status Inactive’ Email
Company Invite n/a
Company Registration Request Page: Customers > Company Configuration
Section: Email Options - Company Registration
Field: Default Company Registration Email
Company Status Active1 Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Active 1" Email
Company Status Active2 Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Active 2" Email
Company Status Blocked Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Blocked" Email
Company Status Pending Approval Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Pending Approval" Email
Company Status Rejected Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Rejected" Email
Customer Status Active Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Customer Status Active’ Email
Customer Status Inactive Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Company Admin Inactive’ Email
Sales Representative Assigned to Company Page: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Sales Rep Assigned’ Email

Magento_CompanyCredit

B2B for Adobe Commerce (Available with B2B for Adobe Commerce only)

Template Configuration path
Credit Limit Allocated Page: Customers > Company Configuration
Section: Company Credit
Field: Allocated Email Template
Credit Limit Updated Page: Customers > Company Configuration
Section: Company Credit
Field: Updated Email Template
Credit Reimbursed Page: Customers > Company Configuration
Section: Company Credit
Field: Reimbursed Email Template
Order Refunded to Company Credit Page: Customers > Company Configuration
Section: Company Credit
Field: Refunded Email Template
Order Reverted to Company Credit Page: Customers > Company Configuration
Section: Company Credit
Field: Reverted Email Template

Magento_Contact

Template Configuration path
Contact Form Page: General > Contacts
Section: Email Options
Field: Email Template

Magento_Customer

Template Configuration path
Change Email Page: Customers > Customer Configuration
Section: Account Information Options
Field: Change Email Template
Change Email and Password Page: Customers > Customer Configuration
Section: Account Information Options
Field: Change Email and Password Template
Forgot Password Page: Customers > Customer Configuration
Section: Password Options
Field: Forgot Email Template
New Account Page: Customers > Customer Configuration
Section: Create New Account Options
Field: Default Welcome Email
New Account (Magento/luma) Page: Customers > Customer Configuration
Section: Create New Account Options
Field: Default Welcome Email
New Account Confirmation Key Page: Customers > Customer Configuration
Section: Create New Account Options
Field: Confirmation Link Email
New Account Confirmed Page: Customers > Customer Configuration
Section: Create New Account Options
Field: Welcome Email
New Account Without Password Page: Customers > Customer Configuration
Section: Create New Account Options
Field: Default Welcome Email Without Password
Remind Password Page: Customers > Customer Configuration
Section: Password Options
Field: Remind Email Template
Reset Password Page: Customers > Customer Configuration
Section: Password Options
Field: Reset Password Template

Magento_CustomerBalance

Adobe Commerce (Adobe Commerce only)

Template Configuration path
Store Credit Update Page: Customers > Customer Configuration
Section: Store Credit Options
Field: Store Credit Update Email Template

Magento_Directory

Template Configuration path
Currency Update Warnings Page: General > Currency Setup
Section: Scheduled Import Settings
Field: Error Email Template

Magento_Email

Template Configuration path
Footer n/a
Footer (Magento/luma) n/a
Header n/a

Magento_GiftCard

Adobe Commerce (Adobe Commerce only)

Template Configuration path
Gift Card(s) Purchase Page: Sales > Gift Cards
Section: Gift Card Email Settings
Field: Gift Card Notification Email Template

Magento_GiftCardAccount

Template Configuration path
Gift Card Code/Balance Page: Sales > Gift Cards
Section: Email Sent from Gift Card Account Management
Field: Gift Card Template

Magento_GiftRegistry

Template Configuration path
New Registry Page: Customers > Gift Registry
Section: Owner Notification
Field: Email Template
Registry Sharing Page: Customers > Gift Registry
Section: Gift Registry Sharing
Field: Email Template
Registry Update Page: Customers > Gift Registry
Section: Gift Registry Update
Field: Email Template

Magento_InventoryInStorePickupSales

Template Configuration path
Order is Ready for Pickup Page: Sales > Sales Emails
Section: Order Ready For Pickup in Store
Field: Order Ready For Pickup Email Template
Order is Ready for Pickup For Guest Page: Sales > Sales Emails
Section: Order Ready For Pickup in Store
Field: Order Ready For Pickup Email Template for Guest

Magento_Invitation

Template Configuration path
Customer Invitation Page: Customers > Invitation
Section: Email
Field: Customer Invitation Email Template

Magento_NegotiableQuote

B2B for Adobe Commerce (Available with B2B for Adobe Commerce only)

Template Configuration path
Declined Quote Page: Sales > Sales Emails
Section: Quote
Field: Declined Quote Template (to Buyer)
Expiration Date Reset Page: Sales > Sales Emails
Section: Quote
Field: Expiration Date Reset
Expiration Warning Page: Sales > Sales Emails
Section: Quote
Field: Quote Expiration (in 48 hrs)
Expiration Warning1 Page: Sales > Sales Emails
Section: Quote
Field: Quote Expiration (in 24 hrs)
New Quote Page: Sales > Sales Emails
Section: Quote
Field: New Quote Template (to Seller)
Updated Quote Page: Sales > Sales Emails
Section: Quote
Field: Updated Quote Template (to Seller)

Magento_Newsletter

Template Configuration path
Subscription Confirmation Page: Customers > Newsletter
Section: Subscription Options
Field: Confirmation Email Template
Subscription Success Page: Customers > Newsletter
Section: Subscription Options
Field: Success Email Template
Unsubscription Success Page: Customers > Newsletter
Section: Subscription Options
Field: Unsubscription Email Template

Magento_ProductAlert

Template Configuration path
Cron Error Warning Page: Catalog > Catalog
Section: Product Alerts Run Settings
Field: Error Email Template
Price Alert Page: Catalog > Catalog
Section: Product Alerts
Field: Price Alert Email Template
Stock Alert Page: Catalog > Catalog
Section: Product Alerts
Field: Stock Alert Email Template

Magento_PurchaseOrder

Template Configuration path
Approved Purchase Order Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Approved Purchase Order
Approved, requires payment Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Approved, requires payment details (to Buyer)
Comment added to Purchase Order Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Comment added to Purchase Order
Created and Auto-approved Purchase Order Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Created and Automatically approved Purchase Order (to Buyer)
Created and automatically approved, requires payment details Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Created and automatically approved, requires payment details (to Buyer)
Created and requires Approval Purchase Order Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Created and requires Approval Purchase Order (to Buyer)
Error creating Order from Purchase Order Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Error creating Order from Purchase Order (to Buyer)
Purchase Order requires Approval Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Purchase Order requires Approval (to Approver)
Rejected Purchase Order Page: Sales > Sales Emails
Section: Purchase Order Approval
Field: Rejected Purchase Order (to Buyer)

Magento_Reminder

Adobe Commerce (Adobe Commerce only)

Template Configuration path
Promotion Notification/Reminder Page: Customers > Promotions
Section: Automated Email Reminder Rules
Field: Reminder Email Sender

Magento_Reward

Adobe Commerce (Adobe Commerce only)

Template Configuration path
Balance Update Page: Customers > Reward Points
Section: Email Notification Settings
Field: Balance Update Email
Points Expiry Warning Page: Customers > Reward Points
Section: Email Notification Settings
Field: Reward Points Expiry Warning Email

Magento_Rma

Adobe Commerce (Adobe Commerce only)

Template Configuration path
New RMA Page: Sales > Sales Emails
Section: RMA
Field: RMA Email Template
New RMA for Guest Page: Sales > Sales Emails
Section: RMA
Field: RMA Email Template for Guest
RMA Admin Comments Page: Sales > Sales Emails
Section: RMA Admin Comments
Field: RMA Comment Email Template
RMA Admin Comments for Guest Page: Sales > Sales Emails
Section: RMA Admin Comments
Field: RMA Comment Email Template for Guest
RMA Authorization Page: Sales > Sales Emails
Section: RMA Authorization
Field: RMA Authorization Email Template
RMA Authorization for Guest Page: Sales > Sales Emails
Section: RMA Authorization
Field: RMA Authorization Email Template for Guest
RMA Customer Comments Page: Sales > Sales Emails
Section: RMA Customer Comments
Field: RMA Comment Email Template

Magento_Sales

Template Configuration path
Credit Memo Update Page: Sales > Sales Emails
Section: Credit Memo Contents
Field: Credit Memo Comment Email Template
Credit Memo Update (Magento/luma) Page: Sales > Sales Emails
Section: Credit Memo Comments
Field: Credit Memo Comment Email Template
Credit Memo Update for Guest Page: Sales > Sales Emails
Section: Credit Memo Comments
Field: Credit Memo Comment Email Template for Guest
Credit Memo Update for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Credit Memo Comments
Field: Credit Memo Comment Email Template for Guest
Invoice Update Page: Sales > Sales Emails
Section: Invoice Comments
Field: Invoice Comment Email Template
Invoice Update (Magento/luma) Page: Sales > Sales Emails
Section: Invoice Comments
Field: Invoice Comment Email Template
Invoice Update for Guest Page: Sales > Sales Emails
Section: Invoice Comments
Field: Invoice Comment Email Template for Guest
Invoice Update for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Invoice Comments
Field: Invoice Comment Email Template for Guest
New Credit Memo Page: Sales > Sales Emails
Section: Credit Memo
Field: Credit Memo Email Template
New Credit Memo (Magento/luma) Page: Sales > Sales Emails
Section: Credit Memo
Field: Credit Memo Email Template
New Credit Memo for Guest Page: Sales > Sales Emails
Section: Credit Memo
Field: Credit Memo Email Template for Guest
New Credit Memo for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Credit Memo
Field: Credit Memo Email Template for Guest
New Invoice Page: Sales > Sales Emails
Section: Invoice
Field: Invoice Email Template
New Invoice (Magento/luma) Page: Sales > Sales Emails
Section: Invoice
Field: Invoice Email Template
New Invoice for Guest Page: Sales > Sales Emails
Section: Invoice
Field: Invoice Email Template for Guest
New Invoice for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Invoice
Field: Invoice Email Template for Guest
New Order Page: Sales > Sales Emails
Section: Order
Field: New Order Confirmation Template
New Order (Magento/luma) Page: Sales > Sales Emails
Section: Order
Field: New Order Confirmation Template
New Order for Guest Page: Sales > Sales Emails
Section: Order
Field: New Order Confirmation Template for Guest
New Order for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Order
Field: New Order Confirmation Template for Guest
New Shipment Page: Sales > Sales Emails
Section: Shipment
Field: Shipment Email Template
New Shipment (Magento/luma) Page: Sales > Sales Emails
Section: Shipment
Field: Shipment Email Template
New Shipment for Guest Page: Sales > Sales Emails
Section: Shipment
Field: Shipment Email Template for Guest
New Shipment for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Shipment
Field: Shipment Email Template for Guest
Order Update Page: Sales > Sales Emails
Section: Order Comments
Field: Order Comment Email Template
Order Update (Magento/luma) Page: Sales > Sales Emails
Section: Order Comments
Field: Order Comment Email Template
Order Update for Guest Page: Sales > Sales Emails
Section: Order Comments
Field: Order Comment Email Template for Guest
Order Update for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Order Comments
Field: Order Comment Email Template for Guest
Shipment Update Page: Sales > Sales Emails
Section: Shipment Comments
Field: Shipment Comment Email Template
Shipment Update (Magento/luma) Page: Sales > Sales Emails
Section: Shipment Comments
Field: Shipment Comment Email Template
Shipment Update for Guest Page: Sales > Sales Emails
Section: Shipment Comments
Field: Shipment Comment Email Template for Guest
Shipment Update for Guest (Magento/luma) Page: Sales > Sales Emails
Section: Shipment Comments
Field: Shipment Comment Email Template for Guest

Magento_ScheduledImportExport

Adobe Commerce (Adobe Commerce only)

Template Configuration path
Export Failed Page: Advanced > System
Section: Scheduled Import/Export File History Cleaning
Field: Export Failed Template
File History Clean Failed Page: Advanced > System
Section: Scheduled Import/Export File History Cleaning
Field: Error Email Template
Import Failed Page: Advanced > System
Section: Scheduled Import/Export File History Cleaning
Field: Import Failed Template

Magento_SendFriend

Template Configuration path
Send Product Link to Friend Page: Catalog > Email to a Friend
Section: Email Templates
Field: Select Email Template

Magento_Sitemap

Template Configuration path
Sitemap Generation Settings Page: Catalog > XML Sitemap
Section: Generation Settings
Field: Error Email Template

Magento_TwoFactorAuth

Template Configuration path
2FA Configuration Required by User n/a
2FA Configuration Required for the Application n/a

Magento_User

Template Configuration path
Forgot Admin Password Page: Advanced > Admin
Section: Admin User Emails
Field: Forgot Password Email Template
User Notification Page: Advanced > Admin
Section: Admin User Emails
Field: User Notification Template
New User Notification Page: Advanced > Admin
Section: Admin User Emails
Field: New User Notification Template

Magento_Wishlist

Template Configuration path
Magento Wish List Sharing Page: Customers > Wish List
Section: Share Options
Field: Email Template

On this page