How to change the product list template of one category without affacting product list templates for other categories

How to change the product list template of one category without affacting product list templates for other categories

August 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to change the product list template of one category without affacting product list templates for other categories

Customizing Product Listing Templates for Specific Categories

As an e-commerce developer, you often need to customize the product listing templates based on specific categories or sub-categories. In this post, we’ll guide you through changing the product list template for one category without affecting other categories.

Understanding Category-Based Template Switching

In Magento 2, each category has a default layout that applies to all of its products by default. However, you can override this behavior for specific categories using custom templates and layout updates.

Step-by-Step Guide: Changing One Category’s Product List Template

1. Create the Custom Layout Update XML File

First, create an XML file in your theme’s app/design/frontend/[Vendor]/[ThemeName]/Magento_Catalog/layout folder (create the folders if they don’t exist). Name this file something like catalog_category_view.xml.

<!-- app/design/frontend/Vendor/ThemeName/Magento_Catalog/layout/catalog_category_view.xml -->
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <update handle="catalog_category_default"/>
    <!-- Update the category view for a specific category ID -->
    <referenceContainer name="category.products.list">
        <block class="Magento\Framework\View\Element\Template" template="Magento_Catalog::product/list.phtml"
               name="custom.category.product.list">
            <arguments>
                <argument name="title" xsi:type="string">Custom Product List</argument>
            </arguments>
        </block>
    </referenceContainer>
</page>

In this example, we’re creating a new block named custom.category.product.list and assigning it the custom template located at Magento_Catalog::product/list.phtml.

2. Create the Custom Product Listing Template

Next, create the custom listing template in your theme’s app/design/frontend/[Vendor]/[ThemeName]/Magento_Catalog/templates/product/ folder.

<!-- app/design/frontend/Vendor/ThemeName/Magento_Catalog/templates/product/list.phtml -->
<?php
$products = $block->getLoadedProductCollection();
foreach ($products as $product) {
    ?>
    <div class="product-item">
        <h2><?= $product->getName() ?></h2>
        <p>Price: <?= $product->getPriceHtml() ?></p>
        <p>Weight: <?= $product->getWeight() ?> kg</p>
    </div>
    <?php
}
?>

In this custom template, we’re only displaying the product title, price, and weight. You can modify this layout to meet your specific requirements.

3. Assign the Custom Layout Update to Your Category

Finally, update your desired category in the Magento admin panel:

  • Navigate to Catalog > Categories.
  • Select the category you want to change.
  • In the “Design” tab, select your custom layout update file (e.g., catalog_category_view.xml) from the “Custom Layout Update” dropdown.
  • Save your changes.

Conclusion

By following this approach, you can successfully change the product list template for one specific category without affecting other categories or sub-categories in your Magento 2 store. This method allows for a high degree of customization within the existing Magento framework.

Remember to always test your changes thoroughly before deploying them to a production environment. If you need further assistance with Magento development, feel free to explore our comprehensive guides and resources at Laravel Company.

Magento 2 Catalog Themes Configuration

Our network