How to show breadcrumbs on my pages in magento?

How to show breadcrumbs on my pages in magento?

September 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to show breadcrumbs on my pages in magento?

Displaying Breadcrumbs on Your Magento Pages

If you’re having trouble showing breadcrumbs on your pages in Magento, you’ve come to the right place. In this post, I’ll guide you through the process of displaying breadcrumbs correctly on your 1column.phtml pages.

Understanding the Breadcrumbs Layout Handle

Before we dive into the code, let’s quickly understand how Magento handles the breadcrumb block. By default, the breadcrumbs block is assigned to the cms_index_index layout handle in the app/design/frontend/base/default/layout/cms_index.xml file.

<layout version="1.0">
    <default>
        <reference name="root">
            <action method="setTemplate"><template>page/3columns.phtml</template></action>
            <block type="cms/block" name="content" before="-">
                <action method="setBlockId"><block_id>homepage_content</block_id></action>
            </block>
        </reference>
    </default>
    <cms_index_index translate="label">
        <update handle="cms_page_view"/>
        <reference name="root">
            <title_replace replace="Page Title"></title_replace>
            <remove name="right"/>
            <remove name="left"/>
            <action method="setTemplate"><template>page/1column.phtml</template></action>
        </reference>
    </cms_index_index>
</layout>

Notice the line <action method="setTemplate"><template>page/1column.phtml</template></action> in the cms_index_index layout handle. This is where your one-column template file is loaded.

The Correct Way to Display Breadcrumbs

Now, let’s fix the issue with displaying breadcrumbs on your pages. The error you encountered was due to trying to access a non-existent block named breadcrumbs. To resolve this, we need to first check if the breadcrumbs block exists before calling its toHtml() method.

<?php
if ($this->getLayout()->getBlock('breadcrumbs')) {
    echo $this->getLayout()->getBlock('breadcrumbs')->toHtml();
}
?>

In this code snippet, we first use the ternary operator to check if the breadcrumbs block exists. If it does exist, we then echo its HTML output using the toHtml() method.

An Alternative Approach with Helper Functions

If you prefer a more elegant solution, you can create a helper function in your module to display the breadcrumbs:

// app/code/Vendor/Module/etc/module.xml

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Vendor_Module" setup_version="1.0.0">
        <sequence>
            <module name="Magento_Backend"/>
        </sequence>
    </module>
</config>

In your module, create a helper class to handle the breadcrumb display:

// app/code/Vendor/Module/Helper/Data.php

namespace Vendor\Module\Helper;

use Magento\Framework\App\Helper\AbstractHelper;
use Magento\Framework\App\Helper\Context;

class Data extends AbstractHelper
{
    public function getBreadcrumbsHtml()
    {
        if ($this->_layout->getBlock('breadcrumbs')) {
            return $this->_layout->getBlock('breadcrumbs')->toHtml();
        }

        return '';
    }
}

Finally, include the helper in your template file:

<?php echo $block->getLayout()->createBlock('\Vendor\Module\Helper\Data')->getBreadcrumbsHtml(); ?>

Conclusion

Displaying breadcrumbs on your Magento pages requires a proper understanding of layout handles and block assignments. By following the steps outlined above, you should now be able to show breadcrumbs correctly on your 1column.phtml pages without encountering any errors.

Remember, if you’re looking for more advanced solutions or need assistance with other aspects of Magento development, feel free to explore our extensive resources at LaravelCompany. We offer a wide range of services, including custom development, module creation, and integration support.

Indexing Themes

Our network