Change magento header template only on product page

Change magento header template only on product page

October 2, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Change magento header template only on product page

Changing Magento Header Template for Product Pages Only

In this guide, we’ll show you how to change the header template specifically for product pages in your Magento store using the SM Market default theme.

Problem Description You want to use two different header templates: header.phtml (already assigned to all pages) and header4.phtml, which you only want to display on the product page. You’ve created a layout.xml file but the updates aren’t working as expected.

Step-by-Step Solution

  1. Understand Magento Layout Files In Magento, layouts define how content is rendered on each page. They are XML files located under app/design/frontend/SM_Market/default/layout.

  2. Create a New Layout File First, let’s create a new layout file named custom_layout.xml inside the directory:

    /public_html/app/design/frontend/sm_market/default/layout
    
  3. Update Your Local XML File Open your existing local.xml file and add the following code within the <layout> tags:

<default>
    <reference name="header">
        <action method="setTemplate" translate="label">
            <label>Page Header</label>
            <template>page/html/header.phtml</template>
        </action>
    </reference>

    <!-- Add this block for the product page -->
    <catalog_product_view translate="label">
        <update handle="default"/>
        <reference name="header">
            <action method="setTemplate" translate="label">
                <label>Page Header (Product)</label>
                <template>page/html/header4.phtml</template>
            </action>
        </reference>
    </catalog_product_view>
</default>
  1. Save and Verify Changes Save the local.xml file, then clear your Magento cache:

    rm -rf var/cache/*
    
  2. Test on Your Product Page Visit a product page in the frontend of your store to see if the new header template (header4.phtml) is now displayed.

Best Practices

  • Always backup your files before making changes.
  • Use unique labels for each action method (e.g., “Page Header” and “Page Header (Product)”).
  • If you’re still having issues, double-check that your cache was cleared properly.
  • Consider using a child theme for more advanced customizations to avoid losing changes during updates.

Conclusion

Changing the header template only for specific product pages in Magento involves creating a new layout file and updating the existing local.xml with the appropriate XML code. This solution allows you to maintain separate header designs for different sections of your store without duplication or confusion in your layout files.

Remember, if you’re looking to extend this functionality or need more advanced customizations, consider exploring the power of Magento’s theme inheritance system.

Happy coding! Let us know if you have any further questions.

Catalog Themes Configuration Errors

Our network