Magento2 - Override Template order summary in sales email order

Magento2 - Override Template order summary in sales email order

August 5, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento2 - Override Template order summary in sales email order

Overriding Magento2 Order Summary Template for Sales Email

You’re on the right track towards customizing your Magento2 sales email order summary. Let’s go through the steps required to successfully override the default template.

Understanding the Current Setup

The current setup is using a layout handle to render the order items:

{{layout handle="sales_email_order_items" order=$order area="frontend"}}

This handle points to a file located at /app/design/frontend/Corra/Mytheme/Magento_Sales/templates/email/items/order/default.phtml. The module you created (Corra_Sales) should have the necessary files in place for the override.

Directory Structure and Files

Your directory structure should look like this:

app/code
├── Corra
│   └── Sales
│       ├── view
│       │   └── frontend
│       │       ├── layout
│       │       │   └── sales_email_order_renderers.xml
│       │       └── templates
│       │           └── email
│       │               └── items
│       │                   └── order
│       │                       └── default.phtml

The Layout XML File: sales_email_order_renderers.xml

Your layout file is correctly pointing to the custom template:

<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd"
      label="Email Creditmemo Items List" design_abstraction="custom">
    <body>
        <referenceBlock name="sales.email.order.renderers">
            <block class="Magento\Sales\Block\Order\Email\Items\Order\DefaultOrder" as="default"
                   template="Corra_Sales::email/items/order/default.phtml"/>
        </referenceBlock>
    </body>
</page>

The Issue and Possible Solutions

The issue seems to lie in the cache or module activation. Here are a few steps you can take:

  1. Clear Cache: Make sure to run these commands in your terminal:

    • rm -rf var/cache/*
    • rm -rf pub/static/frontend/*
    • php bin/magento cache:clean
    • php bin/magento cache:flush
  2. Check Module Status: Ensure your Corra_Sales module is enabled in the Magento admin under Stores > Configuration > Advanced > Advanced. The module should be listed and set to “Enabled”.

  3. Check Permissions: Confirm that the necessary files have correct permissions (755 for directories, 644 for files).

Conclusion

Remember, Magento2 uses a hierarchical system for template resolution. If no custom template is found in your theme or module, it falls back to the default template.

Double-check:

  • The file paths and names are correct.
  • The XML layout file is correctly named (sales_email_order_renderers.xml).
  • The cache has been completely cleared.
  • The module is enabled.
  • Permissions are set properly.

If you’re still having issues, please ensure that there aren’t any typos or inconsistencies in the file paths. The Magento2 system can be sensitive to small errors.

For more detailed guides on template overrides and customization, I recommend checking out Laravel Company’s series on Magento2 development. They provide comprehensive step-by-step tutorials that cover a wide range of topics, including theme creation and module development.

Magento 2 Extensions Themes Configuration

Our network