Magento Store - Remove Block using Update XML

Magento Store - Remove Block using Update XML

July 27, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento Store - Remove Block using Update XML

Removing Static Blocks from Specific Magento Pages

Are you looking to exclude a static block from appearing on one of your Magento CMS pages? You’re not alone! Many developers face this common challenge when trying to customize their storefront layout. In this guide, we’ll walk through the process step-by-step and provide clear examples.

Understanding the Basics: Your Current Setup

You’ve already set up a static block using the following code in your template file:

<?= $this->getLayout()->createBlock('cms/block')->setBlockId('leftSB1')->toHtml() ?>

This line of code creates an instance of the CMS block and sets its ID to ‘leftSB1’. It then generates the HTML output for this block.

The Challenge: Excluding a Block from a Specific Page

Now, you want to remove this block from a particular CMS page. The key lies in manipulating the layout XML files that Magento uses to render its pages.

Step 1: Locate the Layout Update XML File

The first step is to find the appropriate layout file for your CMS page. By default, Magento uses the page.xml file located at:

app/design/frontend/<your_package>/<your_theme>/layout/page.xml

If you’re using a custom layout file for your specific CMS page (which is recommended), look for it in this directory.

Step 2: Add the Exclude Block Instruction

Open the layout XML file and find the <reference name="left"> section, which corresponds to the left sidebar. Here, you’ll add an unsetChild() instruction to remove the specific block:

<reference name="left">
    <block type="cms/block" template="cms/block.phtml" name="block.leftSB1" before="-">
        <action method="setBlockId"><block_id>leftSB1</block_id></action>
        <remove name="block.leftSB1" />
    </reference>

In this example, we’re using <remove name="block.leftSB1" /> to instruct Magento to exclude the block with the ID ‘leftSB1’ from the layout.

Step 3: Save and Verify Changes

Save the XML file, then clear your cache in Magento (System > Cache Management > Select all and click ‘Flush Cache Stores’). Refresh your CMS page, and you should no longer see the static block displayed in the left sidebar.

Best Practices for Custom Layouts

It’s a good practice to create custom layout files for each unique page or category. This allows for more fine-grained control over your site’s layout structure. Remember to follow the naming convention page_<your_page_id>.xml when creating these files.

For more advanced layout manipulations, consider using XML child elements and custom block names to build complex layouts that suit your business needs.

Conclusion: Customizing Magento Layouts

Excluding static blocks from specific pages is a fundamental aspect of building a customized Magento store. By understanding the Layout Update XML syntax and leveraging the power of custom layout files, you can achieve precise control over your site’s appearance.

Don’t forget to keep your code organized using version control systems like Git, which is crucial for maintaining a healthy development workflow in any e-commerce project.

If you’re looking for professional assistance with Magento development or have other questions about e-commerce best practices, feel free to reach out to us at Laravel Company. Our team of expert developers stands ready to help you navigate the complexities of Magento and build a successful online business.

Themes

Our network