Toolbar custom position

Toolbar custom position

October 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Toolbar custom position

Magento Toolbar Custom Position: Solving the Breadcrumbs Issue

If you’ve recently updated your Magento installation from version 1.7 to 1.9 and find that your custom toolbar isn’t showing up in the breadcrumbs block, don’t worry—you’re not alone. This is a common issue that can be resolved with some strategic adjustments.

First, let me walk you through the problem as described by our user:

The current XML code for the local.xml file looks like this:

<catalog_category_layered>
    <reference name="breadcrumbs">
        <block type="catalog/product_list" name="toolbar_only" template="catalog/product/list/toolbar_only.phtml">
            <block type="catalog/product_list_toolbar" name="product_list_toolbar" template="catalog/product/list/toolbar.phtml"></block>
            <action method="setToolbarBlockName"><name>product_list_toolbar</name></action>
        </block>
    </reference>
</catalog_category_layered>

<catalog_category_default>
    <reference name="breadcrumbs">
        <block type="catalog/product_list" name="toolbar_only" template="catalog/product/list/toolbar_only.phtml">
            <block type="catalog/product_list_toolbar" name="product_list_toolbar" template="catalog/product/list/toolbar.phtml"></block>
            <action method="setToolbarBlockName"><name>product_list_toolbar</name></action>
        </block>
    </reference>
</catalog_category_default>

In the breadcrumbs.phtml file, they’re trying to output the toolbar with this code:

<?php echo $this->getChildHtml('toolbar_only'); ?>

However, when they use getToolbarHtml() in their toolbar_only.phtml file and do a var_dump, it returns an empty string. They’ve also tried another approach by directly calling the toolbar block, but that too results in an empty string:

<?php
// lets get the toolbar block
$toolbar = $this->getChild('product_list')->getToolbarBlock();
// add the product collection
$toolbar->setCollection($this->getChild('product_list')->getLoadedProductCollection());
$toolbar->toHtml();
?>

So, what’s the right way to output a toolbar in a custom position? Let me explain.

Understanding the Magento Layout System

In order to resolve this issue, we need to understand how the Magento layout system works. The key lies in the way blocks are referenced and rendered within the layout XML files.

When you define a block with a specific type (like catalog/product_list_toolbar) and specify a template for it (toolbar.phtml), you’re essentially instructing Magento to render that particular template file using the data defined by the block’s type.

However, in your case, there seems to be an issue with how the toolbar is being referenced within the breadcrumbs block. The problem might lie in the way the product_list and product_list_toolbar blocks are being defined and referenced.

Best Practices for Magento Layout XML

To ensure that your custom toolbar appears correctly within the breadcrumbs block, I recommend following these best practices when working with Magento layout XML files:

  1. Avoid Nested Blocks: In your current configuration, you have nested blocks (catalog/product_list contains catalog/product_list_toolbar), which can sometimes cause rendering issues.

  2. Use Direct Block References: Instead of referencing a block through another block (like $this->getChild('product_list')), try to reference it directly using the name you’ve defined in your XML file.

  3. Ensure Proper Data Flow: Make sure that the data being passed from one block to another is properly handled and accessible within the context of the rendering process.

Resolving the Issue

Given these best practices, let’s address the issue with your custom toolbar:

  1. In your local.xml file, try removing the nested catalog/product_list block containing the catalog/product_list_toolbar. Instead, define them separately as shown below:
<catalog_category_layered>
    <reference name="breadcrumbs">
        <block type="catalog/product_list" name="product_list" template="catalog/product/list.phtml"/>
        <block type="catalog/product_list_toolbar" name="toolbar_only" template="catalog/product/list/toolbar_only.phtml">
            <action method="setToolbarBlockName"><name>toolbar_only</name></action>
        </block>
    </reference>
</catalog_category_layered>

<catalog_category_default>
    <!-- Repeat the same configuration as above -->
</catalog_category_default>
  1. In your breadcrumbs.phtml file, modify the toolbar output line to reference the toolbar_only block directly:
<?php echo $this->getChildHtml('toolbar_only'); ?>
  1. In your toolbar_only.phtml file, since you’ve already defined the block with the appropriate template (catalog/product/list/toolbar_only.phtml), you should be able to use the standard getToolbarHtml() method without any additional modifications:
<?php echo $this->getToolbarHtml(); ?>

Conclusion

When dealing with custom toolbar positions in Magento, it’s crucial to understand how blocks and templates interact within the layout system. By following the best practices outlined above—avoiding nested blocks, using direct block references, and ensuring proper data flow—you can resolve issues like the one described.

Remember that the key lies in properly defining your blocks with unique names and linking them correctly within your XML files. Always test your changes thoroughly to ensure that both the layout structure and the rendering process are functioning as expected.

For more detailed information on Magento layout customization, I recommend checking out Laravel Company’s guide on Magento 2 Layout Customization for a comprehensive walkthrough of the topic.

Don’t hesitate to reach out if you have any further questions or need additional assistance. Happy coding!

Magento 1 Catalog Themes Configuration

Our network