Working with Magento Layouts

Working with Magento Layouts

August 21, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Working with Magento Layouts

Working with Magento Layouts: A Developer’s Guide

In the world of e-commerce platforms, Magento stands out as a powerful, feature-rich solution for building online stores. However, its complexity can be daunting, especially when it comes to working with layouts in an existing project. Recently, an experienced developer found themselves grappling with Magento layout intricacies and reached out for guidance.

Understanding Magento Layout Structure

Magento layouts are defined using XML files that specify how different blocks of content are arranged on a page. These files allow you to control the structure of your store’s pages without having to modify core PHP code directly.

The provided code snippet is an example of a layout XML file for the catalog_product_view handle, which corresponds to the product view page in Magento:

<catalog_product_view translate="label">
    <!-- ... -->
</catalog_product_view>

Reference Blocks

Within this XML structure, you’ll find references to various blocks that are used to display content on the product page. Each reference block is defined with a type and a name:

<reference name="content">
    <block type="catalog/product_view" name="product.info"
        template="catalog/product/view.phtml">
        <!-- ... -->
    </block>
</reference>

Block Types

The type attribute determines the kind of block being referenced. In this case, most blocks are of the core/template or catalog/product_view type.

Templates

The template attribute specifies which PHP template file is used to render the content for a particular block. For example:

<block type="catalog/product_view_media" name="product.info.media"
    as="media" template="catalog/product/view/media.phtml"/>

This line references the media block (product.info.media) that uses the catalog/product/view/media.phtml template to render the product images.

Working with Layout Blocks in Magento

Floating Content Blocks

To answer the first question, Magento uses CSS to float content blocks left or right within a container. This is not explicitly defined in the layout XML but rather in the associated CSS files that are included on each page by default.

For instance, the catalog_product_view handle includes the following CSS file:

<reference name="head">
    <action method="addItem" type="js_css">catalog/product/view/css.phtml</action>
    <!-- ... -->
</reference>

Within this CSS file, you’ll find styles that float blocks left or right based on their names. For example:

#product-info-media {
    float: left;
}

#product-options-wrapper {
    float: right;
}

Moving Blocks Around

To move the “bottom.phtml” block beneath the media block, we need to manipulate the layout XML file.

First, let’s identify the relevant blocks:

  • The media block is defined as:
<block type="catalog/product_view_media" name="product.info.media"
    as="media" template="catalog/product/view/media.phtml"/>
  • The bottom block is wrapped within another block called product.info.options.wrapper.bottom:
<block type="catalog/product_view" name="product.info.options.wrapper.bottom"
    as="product_options_wrapper_bottom" template="catalog/product/view/options/wrapper/bottom.phtml">
    <!-- ... -->
</block>

Modifying the Layout XML

To move the “bottom.phtml” block beneath the media block, we need to modify the layout file and reorder the blocks:

  1. Locate the content reference block that includes both the media and product_options_wrapper_bottom blocks.

  2. Add an <action method="move" attribute before the product_options_wrapper_bottom block:

<reference name="content">
    <block type="catalog/product_view" name="product.info"
        template="catalog/product/view.phtml">
        <!-- ... -->
    </block>
    <block type="catalog/product_view_media" name="product.info.media"
        as="media" template="catalog/product/view/media.phtml"/>
    <action method="move" destination="content">
        <block>product.info.options.wrapper.bottom</block>
    </action>
</reference>
  1. Save the layout file and clear your Magento cache to see the changes.

Styling the Moved Block

After moving the “bottom.phtml” block, you can apply custom CSS styles to it by adding a unique class or ID to its container:

  1. In your theme’s local.xml layout file, add an <action method="setClassId" attribute to the moved block:
<reference name="content">
    <block type="catalog/product_view" name="product.info"
        template="catalog/product/view.phtml">
        <!-- ... -->
    </block>
    <block type="catalog/product_view_media" name="product.info.media"
        as="media" template="catalog/product/view/media.phtml"/>
    <action method="move" destination="content">
        <block>product.info.options.wrapper.bottom</block>
    </action>
    <action method="setClassId" for="product.info.options.wrapper.bottom">
        <value>custom-bottom-block-class</value>
    </action>
</reference>
  1. Add custom CSS styles to your theme’s CSS file, targeting the new class:
.product-options-wrapper-bottom {
    /* Your custom styles here */
}

Conclusion

Working with Magento layouts can be a complex task, especially when dealing with existing projects. However, understanding the XML structure and how blocks are referenced allows you to modify and extend the functionality of your store.

By following these best practices and taking advantage of resources like the official Magento documentation and community forums, you’ll soon gain confidence in navigating the intricacies of Magento layouts.

Don’t forget to clear your cache after making changes to layout XML files. You can do this manually or use a script provided by Laravel Company to automate the process: Laravel Company - Magento Cache Cleaning Script.

Happy coding, and feel free to reach out if you have any other questions!

Catalog Themes

Our network