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.
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 |
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.
For a detailed list of the configuration settings, see Transactional Emails in the Content and Design Guide.
On the Admin sidebar, go to Content > Design > Configuration.
Find the store view that you want to configure and click Edit in the Action column.
Under Other Settings, expand the Transactional Emails section.
To upload your prepared Logo Image, click Upload and select the file from your system.
For Logo Image Alt, enter alternate text to identify the image.
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.
Choose the Header Template to be used for all transactional email messages.
Choose the Footer Template to be used for all transactional email messages.
When complete, click Save Config.
The list of email templates is organized alphabetically by module.
Template | Configuration path |
---|---|
Hard-declined Authorization |
n/a |
Soft-declined Authorization |
n/a |
Template | Configuration path |
---|---|
Payment Failed |
Page: Sales > Checkout Section: Payment Failed Emails Field: Payment Failed Template |
(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 |
(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 |
Template | Configuration path |
---|---|
Contact Form |
Page: General > Contacts Section: Email Options Field: Email Template |
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 |
(Adobe Commerce only)
Template | Configuration path |
---|---|
Store Credit Update |
Page: Customers > Customer Configuration Section: Store Credit Options Field: Store Credit Update Email Template |
Template | Configuration path |
---|---|
Currency Update Warnings |
Page: General > Currency Setup Section: Scheduled Import Settings Field: Error Email Template |
Template | Configuration path |
---|---|
Footer |
n/a |
Footer (Magento/luma) |
n/a |
Header |
n/a |
(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 |
Template | Configuration path |
---|---|
Gift Card Code/Balance |
Page: Sales > Gift Cards Section: Email Sent from Gift Card Account Management Field: Gift Card Template |
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 |
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 |
Template | Configuration path |
---|---|
Customer Invitation |
Page: Customers > Invitation Section: Email Field: Customer Invitation Email Template |
(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) |
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 |
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 |
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) |
(Adobe Commerce only)
Template | Configuration path |
---|---|
Promotion Notification/Reminder |
Page: Customers > Promotions Section: Automated Email Reminder Rules Field: Reminder Email Sender |
(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 |
(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 |
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 |
(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 |
Template | Configuration path |
---|---|
Send Product Link to Friend |
Page: Catalog > Email to a Friend Section: Email Templates Field: Select Email Template |
Template | Configuration path |
---|---|
Sitemap Generation Settings |
Page: Catalog > XML Sitemap Section: Generation Settings Field: Error Email Template |
Template | Configuration path |
---|---|
2FA Configuration Required by User |
n/a |
2FA Configuration Required for the Application |
n/a |
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 |
Template | Configuration path |
---|---|
Magento Wish List Sharing |
Page: Customers > Wish List Section: Share Options Field: Email Template |