Magento: include custom block in view.phtml

Magento: include custom block in view.phtml

October 5, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento: include custom block in view.phtml

Solving Block Inclusion Issues in Magento: A Comprehensive Guide

In this post, we will walk you through the process of correctly including your custom block within the product view page in Magento. We’ll address common issues that arise when trying to use a Magento block in your template files.

Understanding Block Inclusion

Magento’s XML layout files allow you to easily include blocks anywhere in your page structure. You can add a block as a child to an existing block or reference, giving you fine-grained control over where content appears on the page.

Identifying the Issue: Incorrect Reference and Template Path

You’ve correctly followed Gravity Well’s tutorial for creating a custom block. However, there are two key issues in your current setup:

  1. Incorrect Reference Name: In your local.xml, you’re adding the block under the wrong reference name (header). The header reference is typically used for the page header, not product view content.

  2. Incorrect Template Path: The template path should be relative to your theme’s layout directory (not from the root of your Magento installation).

The Correct Approach: Using the Product Info Reference

To include a block in the product view page, you need to add it as a child of the product.info reference within the catalog_product_view layout handle.

local.xml:

<layout version="0.1.0">
  <default>
    <reference name="catalog_product_view">
      <block type="aimitmanufacturerblock/manufacturerblock" name="manufacturerblock"
             as="manufacturerblock" template="page/html/manufacturerblock.phtml"/>
    </reference>
  </default>
</layout>

In this updated code:

  • We’re using the catalog_product_view layout handle, which is specifically for product view pages.
  • The block type matches your custom block’s name (aimitmanufacturerblock/manufacturerblock).
  • The template path should be relative to your theme’s page/html/ directory.

Including the Block in Your Template

Once you’ve correctly set up the XML layout, including the block in your view.phtml is straightforward:

<?= $this->getChildHtml('manufacturerblock') ?>

Note that:

  • We use the name assigned to our block (manufacturerblock) in the getChildHtml method.
  • The block will be included right where this line appears in your template.

Conclusion

Including a custom block in Magento involves correctly setting up both the XML layout and the template file. By following the steps outlined above—using the catalog_product_view handle, ensuring the correct block type and template path, and properly referencing the block in your view.phtml—you should be able to successfully include your manufacturer block within the product description area.

Remember, Magento’s XML layouts provide a powerful way to manage page structure. By understanding how they work, you can create dynamic and flexible designs that meet your business needs.

For more detailed guides on Magento development, I recommend exploring our tutorials on Laravel Company.

Happy coding!

Catalog Themes Configuration Errors

Our network