Great Magento Emails: Supported Emails and Layouts

This page is part of the Great Magento Emails guide. Start there for what the extension does, installation and the frequently asked questions.

#Editable (full support)

The Contact Form email that your store receives, and emails from Moogento sending modules that declare their templates: NotifyMe (2), GiftEasy (7), HelloCustomer (26) and TrackEasy (4).

Magento's customer emails use the Great Magento Emails layout described below instead (31 in total):

• New Order, New Invoice, New Shipment and New Credit Memo, customer and guest versions (8).
• The four New Account emails, Forgot Password, Remind Password, Reset Password, Change Email, Change Email and Password, and the three newsletter subscription emails (12).
• Order Update, Invoice Update, Shipment Update and Credit Memo Update, customer and guest versions (8).
• Order is Ready for Pickup, customer and guest versions, and the guest order cancellation confirmation (3).

Your design surrounds Magento's own email content, which stays protected. Unsubscribe, preferences and address footers from sending modules are always kept.

#Branded layout (wrapped content)

Other HTML emails using Magento's standard header and footer, typically from other extensions, get your design wrapped around unchanged content, and so do HTML emails without that header and footer. These emails were not tested by Moogento, so each design is checked with the long sample before it is published.

Whether you publish from the editor, switch the design in the email list, apply a design to all eligible emails, or run moogento:emails:design:apply, Great Magento Emails renders the email with the long sample in every store view of the scope and publishes the design only when the email's own content renders inside it with nothing left unprocessed. When the check does not pass, the email keeps its current design and the message names the store view. In the editor's Review & publish panel, Preview with the long sample shows the same render beforehand, and the panel says whether that exact draft has been previewed. Each check is recorded in the audit log. Switching an email back to the native design never needs it.

When Roll back to this or Undo publication would bring back an earlier Modern or Store match design for a third-party email, that version is restored as a draft and the review panel opens, so it is checked again when you publish it. Rolling back to the native design, or undoing a website or store view's first publication so it follows its parent scope again, takes effect directly without the checklist.

#Great Magento Emails layout (order, invoice, shipment and credit memo emails)

When you publish Modern or Store match for New Order, New Invoice, New Shipment or New Credit Memo, Great Magento Emails builds the whole email itself from the order, coloured with your Style Guide. It does not use your storefront theme's order email templates, so a theme that changes or breaks Magento's item table (for example by overriding the order email with its own version) cannot remove the products, totals or addresses from these emails.

Each email shows:

• The order, invoice or credit memo number and a greeting with the customer's first name.
• The order, invoice or refund date, the payment method and, for orders that ship, the delivery method.
• Every product with its image, chosen options (such as colour and size, custom options and bundle parts), SKU, quantity and line total.
• Subtotal, discount (with the discount code or rule label), shipping, tax and the total. Credit memos also show any adjustment refund or adjustment fee and the total refunded. Amounts that other extensions add to or take off the total, such as gift cards, store credit or payment fees, appear together on one Other charges and credits line so the figures always add up. Invoices and credit memos list only their own products and amounts, so partial invoices and partial refunds show the right figures.
• The shipping and billing addresses, and a button to the order in the customer's account. Guests get a link to the Orders and Returns lookup instead.
• The customer's order comment, or the comment you add to an invoice or credit memo when you choose to notify the customer.

Prices follow your store's tax display settings in Stores > Configuration > Sales > Tax > Orders, Invoices, Credit Memos Display Settings. When prices are shown including tax, the email shows tax-inclusive line totals, subtotal and shipping, with an Includes tax line under the total. Amounts use the order's currency. Orders with more than 40 products list the first 40 and say how many more are in the customer's account.

The wording is set by Great Magento Emails and translated with your store view's language. As with plugin layouts, the structure list is hidden and the content cannot be edited in the studio; your Style Guide controls colours, fonts, logo and corners. With Native selected, or without a valid licence, Magento sends its standard template unchanged.

What these designs keep and leave out. Because the email is built from the order, anything your theme's copy of Magento's order, invoice, shipment or credit memo template adds to the body is not shown, such as extra links, a review request, banners or your own email footer text. One thing is kept: PickPack PDF attachment codes (<pickpack_attachment type="invoice">{{orderid order=$order}}</pickpack_attachment> and the other forms in the PickPack guide) found in the template the design replaces, whether that is the theme's file or a saved template from Marketing > Email Templates. They carry over with the order, invoice, shipment or credit memo number filled in, so customers still receive the attached PDF. Codes inside a condition ({{if}}, {{depend}}) or with another id are not carried. The PDF is also attached when a design cannot be fully rendered and the replaced template is sent instead. Previews and test emails never attach PDFs.

TrackEasy. With TrackEasy installed, the New Order and New Invoice designs lead with a Track your order button to TrackEasy's tracking page, shown as the one filled button, with View your order (or View your invoice) below it as an outlined button. Without a TrackEasy tracking page, the view button is the main filled button. The New Shipment design's Track your order button opens that page. Without TrackEasy, the New Shipment button opens the carrier's tracking page when the shipment has one and the order page otherwise.

Updating from version 1.0.1: if you published a design for New Order, New Invoice or New Credit Memo before updating, open each of these emails in the studio, review it and publish it again to switch to this layout. Until you do, they keep their earlier design or go back to the standard Magento template.

#Great Magento Emails layout (account, password and newsletter emails)

When you publish Modern or Store match for one of these emails, Great Magento Emails sends its own short layout instead of wrapping Magento's template or a version your storefront theme supplies: a heading, one line of text, one button and a small note, coloured with your Style Guide.

• Every button and link goes to exactly the address Magento's own email uses, including the password reset, account confirmation and newsletter confirmation links. Emails with a one-time link also show it as text under a "Button not working?" line, so customers can copy it if the button does not work in their email app. Long links wrap on phone screens.
• No email shows a password. Magento's own templates never include it, and neither do these layouts.
• The heading uses the customer's first name when Magento has one, and a version without a name otherwise.
• The password link validity comes from Stores > Configuration > Customers > Customer Configuration > Password Options > Recovery Link Expiration Period (hours).
• The subject line stays Magento's own, so existing subject translations keep working. The rest of the wording is set by Great Magento Emails and translated with your store view's language.
• As with the order emails, the structure list is hidden and the content cannot be edited in the studio. With Native selected, without a valid licence, or when Magento's email is missing a link it needs (for example a password reset token), Magento sends its standard template unchanged. Updating from version 1.1.1: if you published Modern or Store match for any of these emails, or for the order update, Ready for Pickup or guest cancellation emails below, before updating, they keep sending the earlier branded layout around Magento's content until you open them in the studio, review them and publish them again. Publishing the Style Guide or rebuilding the design bindings in the meantime switches them to the standard Magento template until you do, so publish them again straight after updating.

#Great Magento Emails layout (order update, pickup and cancellation emails)

The update emails Magento sends when you add a comment to an order, invoice, shipment or credit memo and choose to notify the customer, the Ready for Pickup email and the guest order cancellation confirmation also get Great Magento Emails' own layout when you publish Modern or Store match. They use the same blocks as the New Order and New Invoice layouts.

• Every one of these emails ends with your store's email address, phone number and opening hours from Stores > Configuration > General > Store Information and Store Email Addresses, when they are set.
• Your comment is shown exactly as you typed it, with line breaks kept and any HTML shown as text, as Magento's own email does.
• The subject line stays Magento's own. With Native selected, without a valid licence, or when Magento's email is missing the order, its invoice, shipment or credit memo, or a valid cancellation link, Magento sends its standard template unchanged.

#Magento emails that keep Magento's own content

These customer emails keep Magento's content inside the branded layout, because their main content arrives already built as HTML or because they are rarely used:

• Price Alert and Stock Alert: the product list comes from Magento as a finished block that also carries the unsubscribe link for each product, so it cannot be rebuilt safely.
• Wish List Sharing: the list of products comes from your storefront theme as a finished block, and Magento does not pass the wish list itself to the email.
• Send Product Link to Friend: Magento turns this feature off by default, and the sender's message arrives as finished HTML.

The Contact Form email goes to your own inbox, not to customers, so it stays an editable email with your design wrapped around Magento's content.

#Plugin layout (NotifyMe, GiftEasy, TrackEasy and HelloCustomer emails)

Emails sent by Moogento plugins ship their own rewritten layout. When you publish Modern or Store match for one of these emails, customers receive that layout, coloured with your Style Guide (colours, fonts, logo and corners). The studio shows a Plugin layout badge on these emails.

• The preview matches what is sent: one frame, drawn with your published or draft Style Guide.
• The wording of these emails is changed in each plugin's own settings, not in the studio. The structure list is hidden for them and edits to their content are refused.
• With Native selected, or without a valid licence, the plugin sends its standard Magento email template.
• If the plugin updates its rewritten layout, the email goes back to the standard template until you review and publish it again.

#Store staff and plain text emails

Emails Magento and the Moogento plugins send to your store staff (payment failure reminders, admin account and two-factor emails, and the AuditEasy, SitemapPro, ExportEasy, CampaignManager, NoMoreSpam Pro and Pulse alerts) are listed in their own Store staff emails group; the StockEasy reports are listed under Other. Your design wraps their content with your logo, colours and fonts; the module's own header and footer are replaced by the design's. Their email styles come from your storefront theme, as customer emails do, not from the admin theme. A staff email sent for the whole installation uses the design of your default store view.

Plain text emails, such as Magento's admin password and currency update emails, are sent as HTML inside the design once a design is published: their text is shown as it is, with line breaks kept. With Native selected they send as plain text exactly as before.

#Resent copies

HelloCustomer's Resend email sends an earlier email again exactly as it was first sent, with the design it had. It is not listed in the studio, because a second design around it would nest two emails.

#Needs integration

An extension's email that cannot be read keeps sending unchanged.

#Customised database templates

Many stores select a template saved in Marketing > Email Templates for an email in Stores > Configuration, for example to add a PickPack PDF code to the New Order email. For the emails with a Great Magento Emails layout (order, invoice, shipment and credit memo emails, their update emails, the account, password and newsletter emails, Ready for Pickup and guest cancellation), the design can be sent instead of that saved template. Your configuration is never changed: the saved template stays selected, and Great Magento Emails decides at send time.

What is carried over and what is not. The studio compares the saved template with Magento's standard template for the store view and lists, in plain language:

• Carried: PickPack PDF codes (with the order, invoice, shipment or credit memo number filled in), codes from other extensions that register with Great Magento Emails (see For developers), and the saved template's subject line.
• Not carried: everything else you added, for example "Google review request", "TrackEasy tracking link (the design adds its own Track your order button)", "Custom block: promo", "Image or banner", "Link to www.instagram.com" or "Custom text: Free delivery on orders over $99". Added lines that only show values the design for that exact email also shows (for the New Order email: the order number and date, addresses, payment, delivery method, items, header and footer) are listed as Changes to Magento's standard wording or layout, because the design shows that information in its own way. Any other value, such as a payment instruction, a gift message, a tax number or a value that belongs to a different email, is listed as Custom template code. Your template's own CSS is listed for information, and counts as content when it adds text or images (for example with content: or a background image). The automatic decision replaces a saved template only when it is Magento's standard template for that email, line for line and in the same order, with nothing removed, re-worded or moved. The only differences it accepts are a PickPack code the email can fill in, the saved subject line, plain CSS and (in the New Order, Invoice and Shipment emails) TrackEasy's tracking link with short link text such as "Track your order". Anything else, including a removed section such as the item list, needs your choice, and the review lists it. When store views using the same saved template have different themes, each store view is compared with its own, the lists are combined, and the review names the store views that differ; nothing counts as safe unless it is safe in every one of them.

Who decides. For each email and scope you choose one of:

• Use the design instead of my saved template: the design is sent, with the carried items. If the saved template is edited afterwards (its text, subject or CSS) and the new version would lose content, it keeps sending and the studio says it changed and needs reviewing again.
• Keep sending my saved template: the saved template is sent exactly as before.
• Decide automatically (the default): the design is sent only when nothing listed under Not carried would be lost, for example when the saved template is a copy of Magento's standard one with a PickPack code added. Otherwise the saved template keeps sending until you choose. At a website or store view whose parent scope has made a choice, this option reads Follow the parent scope and names that choice.

The choice is offered when you switch an email's design (the Use the design instead of my saved template checkbox, ticked when nothing would be lost), in the editor's Review & publish panel (see Publishing and unpublishing), from the Saved template button on the email's row once a design is published, in the bulk window, and with the moogento:emails:design:takeover command. A store view follows its website's choice and a website follows Default configuration, unless they set their own. The choice made for an email is also made for its guest version (Also for guest orders), and the review lists each saved template, for example #38 for New Order and #35 for New Order for Guest. Changing the choice needs the same permission and active licence as publishing a design.

Going back. Choosing Keep sending my saved template, switching the email to Default, undoing the switch or unpublishing the design sends the saved template again exactly as before. The saved template is also sent whenever the design cannot be used: no active licence, the saved template cannot be read, or the design cannot be fully rendered. For the update, account, password, newsletter, pickup and cancellation emails, a saved template that a store view selects for more than one email also keeps sending, and the studio says so; the New Order, Invoice, Shipment and Credit Memo emails can share one saved template between their customer and guest versions.

Saved templates of emails with a Branded layout. For the Contact Form, other extensions' emails and staff emails, the design is sent around your saved template's own content instead of replacing it: everything in the saved template is kept, with its subject line, and only its header and footer are replaced by the design's. Because the email looks different, this only happens once you choose Use the design instead of my saved template; Decide automatically keeps sending the saved template.

Emails that keep their saved template. For an HTML email, a saved template of the Plain Text type is never replaced, because every design is HTML; the review says so. A plain text email is the exception: it takes only a Plain Text saved template, and once you choose Use the design instead of my saved template that saved template's text is sent inside the design, with its line breaks kept, the same way as the email's own text. Emails from Moogento plugins keep sending a saved template if one is selected. NotifyMe, GiftEasy, HelloCustomer and TrackEasy emails send their own templates by default, so they need no saved template to get a design: publish Modern or Store match and their plugin layout is used straight away.

#What happens when things change

#Native template updated

If the underlying Magento template changes after you publish (for example after a Magento upgrade), that email goes back to the normal Magento template for safety. The studio shows a warning; review the email and publish again.

#Great Magento Emails updated

When a release changes how designs are built, bin/magento setup:upgrade rebuilds your published designs for every store view, whatever theme it uses, and they keep sending. Your saved template choices are kept.

Some releases improve one of the Great Magento Emails layouts itself, for example the order and invoice button layout. A published email whose design changed is not sent with the new version until you approve it: until then, in the affected store views, it sends the template it would send without a design (Magento's or your theme's template, or your saved template from Marketing > Email Templates). The Email studio flags these emails so nothing is missed:

• A notice above the email list says how many emails have an updated design ready, with Show them to filter the list (the Update available filter) and Apply all updates.
• Each of those emails shows an Update available badge. Emails you can update at this scope also show Preview to see the updated design and Apply update to send it.
• Applying publishes the email's current design again with the new version. Customers get it from their next email; emails already queued keep their appearance and your saved template choices stay as they are. An update that fails can be applied again.

Applying an update needs both the Edit email drafts and Publish email designs permissions. An email with unpublished draft changes must have its draft published or discarded first, and an email that follows a parent scope's design is updated at that scope.

#Licence

Great Magento Emails checks your licence with Moogento regularly.

• Publishing needs a recent successful check. A successful check covers the next 4 days. If the licence server cannot be reached (for example during a network outage), publishing keeps working for up to 7 more days.
• Sending published designs continues while Moogento has not reported a problem, so a short outage never changes your customers' emails.
• If the licence server reports the licence as invalid, or no licence is recorded for this installation, emails go back to the normal Magento templates. Your designs stay saved and return once the licence is valid again.
• Plugin emails need a valid licence for their designed layout. Without one they use their standard Magento templates, and the studio preview shows the standard template with a note.

#Module disabled or removed

If you disable the module:

• All customer emails return to native templates.
• Your saved designs remain in the database.
• When you re-enable the module, your designs are still there and ready to use.

If you remove the module:

• All customer emails return to native templates.
• Your designs remain in the database.
• If you reinstall the module later, your designs come back.

#Other pages in this guide

• Great Magento Emails overview, installation and FAQs
• Great Magento Emails: Studio, Editor and Publishing
• Great Magento Emails: Settings and Developer Notes