Magento - move block from right to left

Magento - move block from right to left

August 21, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - move block from right to left

Solving Layout Issues: Moving Blocks from Right to Left in Magento

Hello fellow developers! Today, we’re going to tackle a common challenge that many Magento users face - moving blocks from the right column to the left column on a specific page layout. This issue seems straightforward but can be quite tricky if you don’t understand how Magento’s layout system works.

The Problem: Moving Blocks in Magento

You’ve created your first theme and are working on the Catalog Product View page, aiming to convert it from a right-column layout to a left-column layout. You want to move the blocks that currently reside on the right into the left column. Sounds simple enough, right? But no matter what you try, the blocks refuse to budge.

Understanding Magento Layouts

Before we dive into solving this issue, let’s quickly recap how Magento layouts work. In your catalog.xml file, which is part of the default theme, you’ll find the definition for the product view page:

//...

<reference name="right">
    <block type="catalog/product_list_related" name="catalog.product.related" before="-"
           template="catalog/product/list/related.phtml"/>
</reference>

//...

Here, the catalog.product.related block is defined as a child of the right column (name="right").

Attempting to Move the Block

In your local.xml file, you’re trying to move this block using XML directives:

<layout>

// bunch other page directives

<catalog_product_view>
    <reference name="root">
        <action method="setTemplate"><template>page/2columns-left.phtml</template></action>
    </reference>

    <reference name="right">
        <action method="unsetChild"><name>catalog.product.related</name></action>
    </reference>

    <reference name="left">
        <action method="insert"><blockName>catalog.product.related</blockName></action>

        // note that "catalog.leftnav" gets inserted as expected
        <block type="catalog/layer_view" name="catalog.leftnav" after="-"
               template="catalog/layer/view.phtml"/>
    </reference>

</catalog_product_view>

</layout>

In this example, you’re trying to:

  1. Set the page template to 2columns-left.phtml.
  2. Remove the catalog.product.related block from the right column.
  3. Insert the same block into the left column.

The Problem with This Approach

At first glance, this approach seems logical and should work as expected. However, even though inserting catalog.leftnav works perfectly, moving your target block remains stubbornly in place.

This is because Magento’s layout system is complex and doesn’t always behave intuitively. Sometimes the solution lies not in XML directives but in understanding the underlying class methods that these directives call.

The Solution: Understanding Class Methods

After some digging, you’ll find that the Left block from your local.xml file is of type Mage_Core_Block_Text, which inherits from Mage_Core_Block_Abstract. This abstract class contains two important methods:

  1. unsetChild($alias): Unsets a child block.
  2. insert($block, $siblingName = '', $after = false, $alias = ''): Inserts a new child block.

These are the methods called by the XML directives <action method="unsetChild"> and <action method="insert">, respectively.

The Final Solution: Unsetting and Re-Inserting the Block

After understanding these class methods, you can finally solve your issue. Here’s how:

<catalog_product_view>
    <reference name="root">
        <action method="setTemplate"><template>page/2columns-left.phtml</template></action>
    </reference>

    <reference name="right">
        <action method="unsetChild"><alias>catalog.product.related</alias></action>
    </reference>

    <reference name="left">
        <action method="insert"><block>catalog.product.related</block></action>
    </reference>
</catalog_product_view>

Notice the subtle but crucial changes:

  1. I’ve removed <name> and replaced it with <alias> in the unsetChild directive.
  2. I’ve simplified the insert directive by removing unnecessary parameters.

These changes ensure that the XML directives accurately call the class methods, leading to the desired behavior of unsetting and re-inserting the block.

Conclusion

Moving blocks from right to left in Magento is a common yet tricky task. To solve this issue:

  1. Understand how Magento’s layout system works.
  2. Identify the key class methods involved (unsetChild and insert).
  3. Use XML directives that accurately call these methods.

Remember, understanding the underlying system is crucial for solving complex issues like this one. Don’t hesitate to explore Magento’s codebase or consult resources like Alan Storm’s blog AlanStorm.com.

Happy coding!

Catalog Themes Configuration Errors

Our network