Magento: how to update just a block parameter with XML Layout Update

Magento: how to update just a block parameter with XML Layout Update

August 29, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento: how to update just a block parameter with XML Layout Update

Magento: How to Update Just One Block Parameter Using XML Layout Update

If you want to update just one parameter of an existing block reference in Magento using layout updates, follow these steps:

Understanding the Current Layout Structure

The provided XML code is a reference to the catalog_category_default handle that includes several blocks for displaying products. The key line we’re interested in is this:

<block type="catalog/product_list" name="product_list" template="catalog/product/list.phtml">

This block (product_list) uses the list.phtml template to display a list of products.

The Goal: Update Only the Template Parameter

We want to change only the template parameter for the product_list block:

From this line:

<block type="catalog/product_list" name="product_list" template="catalog/product/list.phtml">

To this line:

<block type="catalog/product_list" name="product_list" template="catalog/product/other-list.phtml">

The other-list.phtml should be a valid custom template you’ve created.

Using the Layout Update Functionality

To update just one parameter without removing and recreating the entire block reference, use Magento’s layout update functionality:

  1. Log in to your Magento admin panel.
  2. Navigate to Content > Design > Configuration.
  3. Choose the store view where you want to apply this change.
  4. Click on the “Layout Updates XML” tab for this store view.

Adding a New Layout Update

To update just one parameter, add a new layout update:

  • Click on “Add Layout Update”.
  • In the “Handle(s)” field, enter catalog_category_default. This matches the handle in your provided XML.
  • In the “Layout Update XML” editor, paste this code:
<reference name="product_list">
    <action method="setTemplate">
        <template>catalog/product/other-list.phtml</template>
    </action>
</reference>

This code targets the product_list block within your catalog_category_default handle and sets only its template to other-list.phtml.

Saving Your Layout Update

  • Click “Save Layout Updates”.
  • Verify that your change took effect by checking the frontend of your Magento store.

Conclusion

By following this approach, you can update a single parameter (in this case, the template) for an existing block reference using layout updates in Magento. This method avoids the need to remove and recreate entire block references, making the process more efficient.

Remember, layout updates are applied according to the order of priority defined by Magento’s system. If you have multiple updates targeting the same handle, ensure they’re ordered correctly or use appropriate conditions (ifconfig and ifmodule) as needed.

For more advanced layout customizations and best practices in Magento development, refer to the official Magento documentation at https://laravelcompany.com/magento-documentation.

Catalog API Themes Admin

Our network