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

Adobe Commerce B2B (Available with Adobe Commerce B2B 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

Adobe Commerce B2B (Available with Adobe Commerce B2B 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

Adobe Commerce B2B (Available with Adobe Commerce B2B 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]…/configuration-reference/sales/sales-emails.md)
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
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1