How to place my custom block inside another block in Magento using layout xml?

How to place my custom block inside another block in Magento using layout xml?

July 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to place my custom block inside another block in Magento using layout xml?

Inserting a Custom Block Inside an Existing Base Block in Magento

Hello everyone! I hope this post finds you well. Today, we’re going to tackle a common question asked by many Magento developers: how to insert a custom block inside an existing base block using layout XML.

The Scenario

Let’s say you want to add videos to your product page along with the images that are already there. You’ve managed to list your videos successfully from a module, but the images aren’t showing up when you do this. Your goal is to have both your custom video block and the default image block appear on the same page.

The Approach

The key here is to understand how Magento’s layout system works with blocks. You don’t need to override core classes unless it’s absolutely necessary.

Using Layout XML

In your module’s layout file (usually located under app/code/Company/Module/etc/layout/xml), you can reference existing blocks and insert your custom block within them.

Here’s a basic example:

<catalog_product_view translate="label">
    <reference name="content">
        <reference name="product.info">
            <block type="yourmodule/yourcustomblock"
                   as="yourcustomblock"
                   before="-"
                   template="yourmodule/yourcustomblock.phtml" />
        </reference>
    </reference>
</catalog_product_view>

Let’s break down this XML:

  • catalog_product_view: This is the main layout handle for the product view page.
  • <reference name="content">: The content block contains all the content of the product page.
  • <reference name="product.info">: Inside the content block, we reference the base product.info block. This is where our custom block will be inserted.

Inserting Before or After a Specific Child Block

The key here is to use the appropriate attribute (before or after) and the correct block name to specify the exact position of your custom block.

In your case, you want to place your block between “Availability” and “Prices”. To do this:

  1. First, identify the child blocks inside the base product.info. You can check this by inspecting the layout XML or viewing the page source in a browser.
  2. Let’s assume you find that “Availability” is named product.info.addto and “Prices” is named product.info.price.

You would then modify your layout XML like this:

<catalog_product_view translate="label">
    <reference name="content">
        <reference name="product.info">
            <block type="yourmodule/yourcustomblock"
                   as="yourcustomblock"
                   before="product.info.addto"
                   template="yourmodule/yourcustomblock.phtml" />
        </reference>
    </reference>
</catalog_product_view>

This code tells Magento to insert your custom block (yourcustomblock) immediately before the product.info.addto (Availability) block.

Conclusion

Remember, the key is to understand the hierarchy of blocks on the page and reference them correctly in your layout XML. You rarely need to override core classes for simple UI changes like this one.

If you’re still having trouble, feel free to check out some of our other tutorials on Magento development at Laravel Company. We cover a wide range of topics from beginner guides to advanced techniques.

Happy coding! Let me know if you have any other questions.

Catalog Extensions Themes

Our network