How do I add a full width block to magento?

How do I add a full width block to magento?

August 6, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How do I add a full width block to magento?

Adding Full Width Blocks to Magento: A Comprehensive Guide for Beginners

Hello! I’m excited to help you add full width blocks to your Magento store. Creating a custom full-width banner is a great way to make your category pages stand out and engage visitors. Let’s dive into the step-by-step process.

Understanding Magento Layouts and Blocks

Before we start, let me briefly explain some key concepts:

  • Layout: The layout file defines where blocks are placed on a page.
  • Block: A block is an area on your page that contains content or functionality.
  • XML: Magento uses XML layouts to define the structure of your pages.

The main navigation bar is typically defined in app/design/frontend/<your_package>/<your_theme>/layout/default.xml. The <reference name="header"> element places blocks above the header. You can add a new reference for your banner, like this:

<reference name="before.body">
    <block type="core/template" name="my_full_width_banner" template="template.phtml" />
</reference>

This code creates a new block named “my_full_width_banner” and assigns it the template.phtml template file.

Creating the Full Width Template

Create a new file called template.phtml under app/design/frontend/<your_package>/<your_theme>/template. This is where you’ll place your banner image or HTML content. For example:

<div class="full-width-banner">
    <img src="{{base_url}}media/banners/my_banner.jpg" alt="My Banner">
</div>

The {{base_url}} variable generates the base URL of your website.

Assigning the Block to Specific Pages

To add this banner only to specific pages (like category or CMS pages), you need to modify the layout XML for those pages:

  1. For category pages, update app/design/frontend/<your_package>/<your_theme>/layout/catalog_category_view.xml:
<reference name="before.body">
    <block type="core/template" name="my_full_width_banner" template="template.phtml" />
</reference>
  1. For CMS pages, you’ll need to modify the specific page layout file under app/design/frontend/<your_package>/<your_theme>/layout/page_layout.xml. Find your CMS page ID and add the reference:
<reference name="before.body" ifconfig="page_layout laidout">
    <block type="core/template" name="my_full_width_banner" template="template.phtml" />
</reference>

Making It Responsive

To ensure your banner looks great on mobile devices, add some responsive CSS:

.full-width-banner {
    width: 100%;
    height: auto;
}

@media only screen and (min-width: 768px) {
    .full-width-banner img {
        max-width: none;
        height: 50vh; /* You can adjust this value */
    }
}

Conclusion

Congratulations! You’ve successfully added a full width block to your Magento store. This technique is extremely useful for spicing up category pages or CMS content.

Remember, always make sure to refresh the cache (flush command from Magento’s command line interface) after making layout changes.

If you’d like to explore more advanced customization options and learn best practices, I highly recommend checking out our comprehensive tutorials on Magento development at Laravel Company.

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

Catalog Themes

Our network