Magento2 – Add a custom CSS class to the body element

Magento2 – Add a custom CSS class to the body element

Sometimes we need to customize the whole layout. We can do this by adding a custom class over the body element. For example, in order to specify the text direction we often need to add a custom class to the body element. So based on styling the resulted class will be useful to customize the text direction.

To set the custom class use the attribute instruction to set HTML body tag name and value inside your layout xml file.

    <attribute name="class" value="my-custom-class"/>

A dynamic class can also be added by adding an Observer to the layout_load_before event. Create events.xml under etc/frontend folder. So it should look like : Vendor/Module/etc/frontend/events.xml

Add following snippet to the events.xml:

<?xml version="1.0"?>
<config xmlns:xsi=""
    <event name="layout_load_before">
        <observer name="add_custom_class_event" instance="Vendor\Module\Observer\CustomClass" />

Now add your CustomClass observer. Vendor\Module\Observer\CustomClass

namespace Vendor\Module\Observer;

use Magento\Framework\Event\Observer;
use Magento\Framework\Event\ObserverInterface;

class CustomClass implements ObserverInterface
     * @var \Magento\Framework\View\Page\Config
    private $config;

    private $customClassName = "my-custom-class";

    public function __construct(\Magento\Framework\View\Page\Config $config)
        $this->config = $config;

     * @inheirtDoc
    public function execute(Observer $observer)

This will add my-custom-class to the body element and will be visible on every page on frontend.

Add custom class to the body element

How useful was this post?

Click on a star to rate it!

Average rating / 5. Vote count:

No votes so far! Be the first to rate this post.

As you found this post useful...

Follow us on social media!

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Leave a Reply

Your email address will not be published. Required fields are marked *