Magento 2 add class to body via Layout Update XML

Magento 2 add class to body via Layout Update XML

July 3, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 2 add class to body via Layout Update XML

How to Add CSS Classes to the Body Tag via Layout Update XML in Magento 2

Adding custom CSS classes to the body tag is a common requirement for styling specific pages in Magento 2. This can be achieved through Layout Update XML files, which allow you to modify the page layout and apply classes to various elements.

The Problem: Incorrect Syntax

In your attempt, you’re on the right track by using the referenceContainer element with the root name. However, the issue lies in the syntax for adding attributes to a container. Let’s correct this first.

Correcting the XML Syntax

To add an attribute (like class) to the root container, you need to use the <item name="class"> syntax within the <body> tag. Here’s how it should look:

<body>
    <referenceContainer name="root">
        <item name="class" xsi:type="string">my-css-class</item>
    </referenceContainer>
</body>

In this updated version:

  • We wrap your existing code inside the <body> and </body> tags.
  • The xsi:type="string" attribute is necessary for Magento to recognize the value as a string.
  • Make sure you have the XML namespace declaration at the top of your file: <layout xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc:layout.xsd">

Where to Place This Code

To apply this class to a specific CMS page, you need to add the XML code to your layout update file(s). The location depends on where you want the class to be applied:

  1. For a single CMS page: Add this to the pages.xml file located in <your_magento_2_root>/app/design/frontend/<vendor_name>/<theme_name>/Magento_Cms/layout/pages.xml. If the file doesn’t exist, create it.

  2. For all CMS pages: Create a new layout file in the same directory and name it cms_pages.xml.

  3. For non-CMS pages: You can use the same method for other page types by using the appropriate XML file (e.g., catalog_product_view.xml for product pages).

Conclusion: Easy and Effective Styling

Adding CSS classes to the body tag via Layout Update XML is a powerful way to apply specific styles to different pages in your Magento store. This technique allows you to target elements precisely, ensuring that your site’s appearance remains consistent across all content.

Remember to always clear your cache after making changes to layout files to see the updates take effect. If you’re looking for more advanced styling options or need help with complex CSS structures, consider reaching out to a professional Magento developer or consulting a resources like LaravelCompany.com.

Magento 2 Themes Pricing Errors

Our network