Adding image in Magento via update layout

Adding image in Magento via update layout

August 26, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding image in Magento via update layout

Adding Images to Magento Left Sidebar via Layout Update

Are you trying to add images or other content to the left sidebar of a two-column layout page in your Magento store? You’re not alone! This is a common task for e-commerce developers and site owners.

Understanding Magento Layout Updates

Magento uses XML layouts to define the structure of its pages. You can modify these layouts via the CMS -> Page -> Design area of the admin panel. This is where you’ll make changes to your page’s layout, including adding new elements like images or text blocks.

Can We Add Images Directly in the Layout Update XML?

Unfortunately, the short answer is no, you cannot directly add images using only the layout update XML area. The layout file doesn’t support the <img> tag or any other HTML image syntax. It’s designed to manage the placement and visibility of content blocks.

Creating a Module for Image Addition

To add an image to your Magento sidebar, you’ll need to create a custom module. Here’s a simplified step-by-step guide:

  1. Create the directory structure: Your module should be located in app/code/Vendor/ModuleName. Replace ‘Vendor’ and ‘ModuleName’ with your actual vendor name and desired module name.

  2. Create the registration file: In the root of your module folder, create a new file named registration.php:

<?php

\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::MODULE,
    'Vendor_ModuleName',
    __DIR__
);
  1. Create the config file: Inside the etc directory, create a new XML file named module.xml. Define your module’s information here:
<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
  <module name="Vendor_ModuleName" setup_version="1.0.0" schema_version="1.0.0">
    <sequence>
      <module name="Magento_Backend"/>
      <module name="Magento_Frontend"/>
    </sequence>
  </module>
</config>
  1. Create the layout XML file: In the view/frontend/layout folder, create a new XML file for your custom block (e.g., vendor_module_name_custom_block.xml). Define where you want to place your image:
<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceBlock name="left.permanent.callout">
            <block class="Magento\Framework\View\Element\Template" template="Vendor_ModuleName::image.phtml"/>
        </referenceBlock>
    </body>
</page>
  1. Create the image file: In view/frontend/templates, create a new PHTML file named image.phtml. This is where you’ll place your image:
<img src="<?php echo $this->getViewFileUrl('Vendor_ModuleName/image/your_image.jpg') ?>" alt="Your Image Alt Text">
  1. Upload the image: Upload your image to pub/static/frontend/Vendor_moduleName/en_US/images/your_image.jpg (replace ‘en_US’ with your actual store view).

  2. Enable and install your module: In Magento admin, navigate to Stores -> Settings -> All Stores -> Config -> Advanced -> Module Configuration. Enable your new module.

Conclusion

Adding images to the left sidebar of a Magento page requires a bit more work than simply editing layout XML. You’ll need to create a custom module that includes a layout file to define where you want to place your image, and an image file to actually display it.

This guide provides a high-level overview, but for complete details on creating modules in Magento 2, I recommend checking out the official documentation or our comprehensive guide at LaravelCompany. Remember, always test your changes thoroughly before deploying them to a live site.

Happy coding!

Extensions Themes Admin Pricing

Our network