Customize message template in Magento 2

0
532
Customize message template in Magento 2
Customize message template in Magento 2

In this post, I will show you how to customize message template in Magento 2.

FYI, this is the default Magento message block:

Magento 2 default message block
Magento 2 default message block

This template is defined under vendor/magento/module-theme/view/frontend/templates/messages.phtml, and its name is message.

To customize this message template, you can use referenceBlock and set a new value for the template property, like below:

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceBlock name="messages" template="Vendor_Module::messages.phtml" />
    </body>
</page>

You can also override the block class by overriding the class property:

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceBlock name="messages"
                        class="Vendor\Module\Block\CustomMessageBlock"
                        template="Vendor_Module::messages.phtml" />
    </body>
</page>

That’s how you customize message template in Magento 2.

Have fun!