Email templates

Last update: June 3, 2024

CREATED FOR:

  • Beginner
  • Intermediate
  • Admin
  • Leader

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 Dimensions1 x (display size)3 x (image size)
Width:168 px504 px
Height:48 px144 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

TemplateConfiguration path
Hard-declined Authorizationn/a
Soft-declined Authorizationn/a

Magento_Checkout

TemplateConfiguration path
Payment FailedPage: Sales > Checkout
Section: Payment Failed Emails
Field: Payment Failed Template

Magento_Company

Adobe Commerce B2B (Available with Adobe Commerce B2B only)

TemplateConfiguration path
Assign Company AdminPage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Assign Company Admin’ Email
Assign Company to CustomerPage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Assign Company to Customer’ Email
Company Admin Changed to MemberPage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Company Admin Changed To Member’ Email
Company Admin Set InactivePage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Customer Status Inactive’ Email
Company Inviten/a
Company Registration RequestPage: Customers > Company Configuration
Section: Email Options - Company Registration
Field: Default Company Registration Email
Company Status Active1Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Active 1" Email
Company Status Active2Page: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Active 2" Email
Company Status BlockedPage: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Blocked" Email
Company Status Pending ApprovalPage: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Pending Approval" Email
Company Status RejectedPage: Customers > Company Configuration
Section: Company Status Change
Field: Default 'Company Status Change To Rejected" Email
Customer Status ActivePage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Customer Status Active’ Email
Customer Status InactivePage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Company Admin Inactive’ Email
Sales Representative Assigned to CompanyPage: Customers > Company Configuration
Section: Customer-Related Emails
Field: Default ‘Sales Rep Assigned’ Email