Magento - Add Some HTML on All Pages of my Theme After_Body_Start

Magento - Add Some HTML on All Pages of my Theme After_Body_Start

August 13, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - Add Some HTML on All Pages of my Theme After_Body_Start

Adding HTML After Body Start in Magento: A Step-by-Step Guide

Hello developers! Today, I’m going to guide you through adding custom HTML after the body start section of your Magento theme. This is a common requirement for many projects, and I’ll make sure to explain each step clearly.

The Problem: Missing “Hello World”

You’ve added the following code to app/design/frontend/custompackage/genesis/template/page/custom/siteCanvasAdjustment.phtml:

<p>Hello World</p>

And you’ve updated your local.xml file located at app/design/frontend/custompackage/genesis/local.xml with this layout update:

<layout version="0.1.0">
  <default>
    <reference name="after_body_start">
      <block type="core/template" name="siteCanvasAdjustment" as="siteCanvasAdjustment" template="page/custom/siteCanvasAdjustment.phtml" output="toHtml" before="-" />
    </reference>
  </default>
</layout>

However, despite verifying the theme is installed and testing changes in head.phtml with success, you’re not seeing “Hello World” render on your pages. Don’t worry—we’ll fix this!

The Solution: Understanding Magento Layouts

Magento layouts are XML files that define how to display content on a page. When you add <reference name="after_body_start">, the system knows to execute the block after the entire body content has been added.

Let’s troubleshoot your issue:

  1. File Paths: Ensure your file paths are correct. The siteCanvasAdjustment.phtml file should be located at app/design/frontend/custompackage/genesis/template/page/custom/siteCanvasAdjustment.phtml.

  2. Namespace and Theme Name: Make sure the namespace (custompackage) and theme name (genesis) match in both the local.xml file and the file path.

  3. Layout Update Priority: The syntax <type="core/template" ... output="toHtml"> is correct for adding a PHTML template block. However, you don’t need to specify before="-"—remove that from your code.

  4. Caching Issues: Magento might cache the layout XML. Clear the cache using the command php bin/magento cache:flush.

The Code: Proper Layout Update

Here’s how your local.xml file should look:

<layout version="0.1.0">
  <default>
    <reference name="after_body_start">
      <block class="Magento\Framework\View\Element\Template" name="siteCanvasAdjustment" as="siteCanvasAdjustment" before="-" template="page/custom/siteCanvasAdjustment.phtml"/>
    </reference>
  </default>
</layout>

Note the change in the block type to Magento\Framework\View\Element\Template. This is a more flexible and modern way of adding PHTML templates.

The Conclusion

You should now see “Hello World” rendered after the body start of every page in your theme. Remember, Magento layouts can be complex, but with patience and understanding, you can customize them to fit your needs.

If you’re looking for more advanced Magento customization techniques or need help with a specific project, feel free to check out our Magento development services at Laravel Company. We’ve helped numerous clients optimize their e-commerce platforms and would be happy to assist you as well.

Happy coding!

Themes Configuration Errors

Our network