Learn how to remove breadcrumbs from CMS pages in Magento 2 completely or per page using admin settings or XML layout without breaking your theme. Our Magento Live Support Team is always here to help you.
How To Use Magento 2 Remove Breadcrumbs From cms Pages
Breadcrumbs guide users through your website’s structure, showing exactly where they are in relation to other pages. They usually appear just below the header, after the main menu, and help visitors return to earlier pages quickly. In this article, we’ll show you how to use magento 2 remove breadcrumbs from cms pages completely or only for selected pages, all without affecting your theme or core files.
An Overview
Showing Breadcrumbs for All CMS Pages
Before disabling them, let’s quickly recall how to enable breadcrumbs for all CMS pages if needed:
1. Log in to your Magento Admin Panel and go to Stores > Settings > Configuration.
2. Expand General and click on Web.
3. Open the Default Pages section.
4. Set Show Breadcrumbs for CMS Pages to Yes.
5. Click Save Config.
Once the cache is flushed, breadcrumbs will appear on every CMS page of your site.
Disable Breadcrumbs for All CMS Pages
Now let’s move to the part you came for, how to remove breadcrumbs from CMS pages in Magento 2 across the entire website.
1. Go to Stores > Settings > Configuration again.
2. Expand General > Web.
3. Open Default Pages.
4. Change Show Breadcrumbs for CMS Pages to No.
5. Click Save Config and flush the cache.
This completely removes breadcrumbs from all CMS pages in the frontend.
Remove Breadcrumbs from Specific CMS Pages
Magento doesn’t provide an option in the admin panel to disable breadcrumbs for specific CMS pages. However, you can easily manage this using layout XML.
For Magento 2.3.3 and Below
For older versions (2.3.3 and below), breadcrumbs can be removed directly through the backend:
1. Log in to your Magento Admin and navigate to Content > Pages.
2. Select your CMS page from the grid.
3. Expand the Design section and set the layout you prefer.
4. In the Layout Update XML box, insert the following code:
<referenceContainer name="page.top">
<referenceBlock name="breadcrumbs" remove="true" />
</referenceContainer>5. Save and clear the cache.
Once done, the selected CMS page will load without breadcrumbs.
Clean Up Your Magento Navigation!
For Magento 2.3.4 and Above
From Magento 2.3.4 onwards, the direct Custom Layout Update option was removed for security reasons. To remove breadcrumbs for a specific CMS page, create a layout XML file in your theme folder:
1. Go to:
app/design/frontend/<VendorName>/<ThemeName>/Magento_Cms/layout/
2. Create a file named as:
cms_page_view_selectable_<CMS Page Identifier>_<Layout Update Name>.xml
Here:
- <CMS Page Identifier> = your CMS page’s URL key
- <Layout Update Name> = the name that appears under Custom Layout Update in the backend
Example:
cms_page_view_selectable_about-us_AboutUs.xml
3. Add the following code to the file:
<?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="breadcrumbs" remove="true"/>
</body>
</page>4. Flush your cache.
5. In the admin panel, go to Content > Pages, select your CMS page, expand the Design section, and pick your new layout under Custom Layout Update.
6. Save the page and flush the cache again.
Now, breadcrumbs will be removed only from that specific CMS page.
Conclusion
That’s all you need to do to magento 2 remove breadcrumbs from cms pages, either globally or just for chosen pages. The admin configuration method works best for full-site removal, while the XML layout approach gives you page-level control. Both are clean, safe, and ensure your site stays organized.
Once you’ve set this up, your Magento 2 site will look tidier and more focused on content, exactly how your visitors prefer it.
