Magento 2 Breadcrumbs | How to show/remove, custom & add breadcrumbs XML

What are Magento 2 Breadcrumbs

They are the same as other platform’s breadcrumbs, which are website links that show exactly what categories users clicked on to stay on the page they are viewing. In other words, those help users know where they are on the website in detail.


Breadcrumbs are a useful UX feature because they categorise and supply information to keep users interested and stay on a website. Therefore, Breadcrumbs play an essential role in SEO.

In other words, Breadcrumb is a must-have feature of all websites, even though they are content sites or e-commerce sites. Let’s find out what we can do with it.

How to show Magento 2 Breadcrumbs


To show breadcrumbs is quite easy. Please do the following steps.

  1. Go to Stores > Settings > Configuration.
  2. Expand General tab > Web
  3. In Show Breadcrumbs for CMS Pages, choose Yes.
  4. In Default Web URL, choose CMS.
  5. In CMS Home Page, choose Home Page.
  6. In Default No-route URL, choose CMS/noroute/index.
  7. In CMS No Route Page, choose 404 Not Found.
  8. In CMS No Cookies Page, choose Enable Cookies.
  9. Click Save Config

Magento 2 remove Breadcrumbs in 3 Steps


To remove breadcrumbs, you only need two basic steps different from showing it.

  1. Clean the Use system value checkbox.
  2. Switch the Show Breadcrumbs for CMS Pages to No.
  3. Then, click Save Config.

Magento 2 add Breadcrumbs to the custom page

As you know, Breadcrumbs are only displayed at CMS pages, Category and Product page. So in this blog, I will explain how to add breadcrumbs to a custom extension.

Breadcrumbs are always added to blocks. So you need to open the block that you want to add breadcrumbs to.

1. Write a protected function

protected function _addBreadcrumbs()
	$isShowBreadcrumbs = 1; // You can add this value at Configuration of module.
    if ($isShowBreadcrumbs && ($breadcrumbsBlock = $this->getLayout()->getBlock('breadcrumbs'))) {
                'label' => __('Home'),
                'title' => __('Go to Home Page'),
                'link' => $this->_storeManager->getStore()->getBaseUrl()
        		'label' => 'Add Label here',
        		'title' => 'Add Title here'
        		//'link' => '#'

2. Then you find the function

protected function _prepareLayout()

If there is not this function in the block. You can create it.

3. Then call _addBreadcrumbs() to it:

protected function _prepareLayout()
        // Something of your codes...
        // Something of your codes...

Magento 2 add Breadcrumbs XML

You can also add breadcrumbs to layout XML. It can be added to an override layout or a new layout in your custom extension. In this guide, I use checkout_cart_index.xml layout to guide you.

Firts, create file Your_Vendor/Your_Module/view/frontend/layout/checkout_cart_index.xml. Then add the code below:

<?xml version="1.0"?>
<page xmlns:xsi="" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
       <referenceBlock name="breadcrumbs">
            <action method="addCrumb">
                <argument name="crumbName" xsi:type="string">Home</argument>
                <argument name="crumbInfo" xsi:type="array">
                    <item name="title" xsi:type="string" translate="true">Home</item>
                    <item name="label" xsi:type="string" translate="true">Home</item>
                    <item name="link" xsi:type="string">/</item>
            <action method="addCrumb">
                <argument name="crumbName" xsi:type="string">Shopping Cart</argument>
                <argument name="crumbInfo" xsi:type="array">
                    <item name="title" xsi:type="string" translate="true">Shopping Cart</item>
                    <item name="label" xsi:type="string" translate="true">Shopping Cart</item>

You can see the result below:


Bottom line

Magento 2 Breadcrumbs customization is a difficult technique. However, if you read our article carefully, it might no longer be an obstacle for you. Because this article displays how to show and remove breadcrumbs; add custom breadcrumbs; add breadcrumbs XML comprehensively, hope it will be useful for you.

Did you find this article useful?