Adding a layout block to footer in Magento

Adding a layout block to footer in Magento

July 2, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding a layout block to footer in Magento

Are you trying to customize your Magento store’s footer but struggling with layout XML? You’re not alone! In this post, we’ll walk through how to add a custom block to the footer using Magento 2’s layout system.

Understanding Magento’s Layout System

Before diving into code, let’s briefly recap Magento’s layout structure. The layout is defined in XML files located under app/design/frontend/{vendor}/{theme}/layout. Each file corresponds to a specific page or module.

The root element of the layout XML is <layout> which contains various <update> and <referenceBlock> elements that define how blocks are added, updated, or rearranged on a page. Understanding this structure is key to modifying your store’s layout.

Your Current Approach: Almost There!

You’ve already made some progress by creating your custom PHTML file at /app/design/frontend/mytemplate/default/template/page/html/footer.cat.links.phtml. Great work! You’re also on the right track with adding a <block> element to the layout XML under page.xml.

However, there are a few tweaks needed in your approach.

The Correct Block Type

You mentioned using “catalog/navigation” as the block type. While this might seem appropriate for categories, Magento 2 uses different types for navigation blocks:

  • For top menu (main navigation): Use Magento\Theme\Block\Html\Topmenu
  • For footer links: Use Magento\Theme\Block\Html\Footer

So in your case, you should use Magento\Theme\Block\Html\Footer as the block type.

Proper XML Structure

Your XML structure looks almost correct. However, there are some slight modifications needed:

<block type="Magento\Theme\Block\Html\Footer" name="footer" as="footer" template="Magento_Theme::html/footer.phtml">
    <block type="Magento\Theme\Block\Html\Footer" name="footer.cat.links" as="footerCatLinks" template="page/html/footer.cat.links.phtml"/>
</block>

A few things to note:

  • We’re using the correct block type for footer.
  • The child <block> element has been moved inside the main footer block.
  • The template path should be relative to your theme’s directory.

Calling the Block in PHTML

In your footer.phtml file, you were on the right track with trying to call the new block using $this->getChildHtml('footerCatLinks'). However, since your custom block is a child of the footer block, you should reference it as such:

<?= $block->getChildHtml('footer_cat_links') ?>

Note that we’re using 'footer_cat_links' instead of 'footerCatLinks', following Magento’s convention for naming blocks.

Refreshing Cache

You mentioned refreshing the cache, which is a crucial step in Magento development. After making changes to layout XML files, always remember to:

  1. Clear the generated code (bin/magento setup:upgrade)
  2. Flush the cache (bin/magento cache:flush)

These commands ensure that your layout changes are applied correctly.

Conclusion

Adding a custom block to Magento’s footer is a common task in theme development. By understanding how the layout XML works and following best practices, you can easily customize your store’s appearance without resorting to hacky modifications.

Remember, Magento encourages a decoupled architecture with clear separation of concerns. Keep your logic out of your templates and use layout XML for structuring content.

If you’re looking for more advanced Magento development tips and resources, check out the Magento Development blog at Laravel Company. We regularly publish articles on best practices, performance optimization, and new features in Magento 2.

Magento 2 Catalog Extensions Themes

Our network