magento remove breadcrumbs from home only with local.xml

magento remove breadcrumbs from home only with local.xml

July 6, 2026 · Illustrated author avatarBy Stefan Bogdanescu
magento remove breadcrumbs from home only with local.xml

Removing Breadcrumbs from Magento Homepage Using local.xml

As a senior developer and technical blogger, I’m often asked by Magento users how to remove breadcrumbs only from the homepage using the local.xml file. While it seems straightforward, many users encounter issues with their current approach.

Understanding Magento Layout Files

Before we dive into the solution, let’s quickly understand how Magento layout files work:

  • The cms_index_index layout handle is responsible for rendering the homepage.
  • The root reference node contains all the containers and blocks on the page by default.

Incorrect Approach: Removing Breadcrumbs

The user in your question attempted to remove the breadcrumbs block using this XML code in their local.xml file:

<cms_index_index>
    <reference name="root">
        <remove name="breadcrumbs"/>
    </reference>
</cms_index_index>

While this seems correct, it doesn’t work as expected because the name attribute refers to the block identifier, not the container. The breadcrumbs are actually rendered using a container called content, which contains the breadcrumbs block.

Correct Approach: Removing Breadcrumbs

To remove the breadcrumbs from the homepage, you need to update your local.xml file as follows:

<cms_index_index>
    <remove name="content" />
</cms_index_index>

Here’s what we’re doing:

  1. We use the cms_index_index layout handle for the homepage.
  2. The <remove> node is used to eliminate the specified container.
  3. By removing the content container, we automatically exclude all blocks inside it, including the breadcrumbs.

Verifying the Changes

After making this change, clear your Magento cache and refresh the homepage:

  1. Navigate to System > Cache Management in your Magento admin panel.
  2. Select all cache types and click “Flush Magento Cache”.
  3. Refresh or visit your homepage.

You should now see that the breadcrumbs have been removed from only the homepage.

Conclusion

In this post, we’ve explained how to remove breadcrumbs from a single page (the homepage) in Magento using the local.xml file. The key is understanding the difference between containers and blocks, and knowing which container houses the breadcrumbs block.

Remember that layout files are an essential part of Magento’s architecture, allowing you to customize the look and feel of your store with precision. Don’t hesitate to explore these files further as you build out your e-commerce site.

For more advanced tutorials on Magento development, I recommend checking out the resources at LaravelCompany. They have a wealth of articles covering everything from performance optimization to custom theme development.

Themes Configuration Errors

Our network