Adding custom CSS to Magento Homepage

Adding custom CSS to Magento Homepage

August 20, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding custom CSS to Magento Homepage

Adding Custom CSS to Magento Homepage Without /base/ Path

As a Magento developer, you might encounter issues when trying to add custom CSS files to your CMS homepage. The default configuration often includes the /base/ path in the URL, which can cause your styles not to load correctly. In this guide, we’ll walk through how to properly add custom CSS to your homepage without the unwanted /base/ path.

Understanding the Issue

When you update the Layout XML for your homepage under CMS > Pages > Home > Design, Magento includes the /base/ path before your theme name. This is because by default, Magento inherits styles from the base theme. However, this can lead to styling conflicts or incorrect paths when trying to load your custom CSS.

The Problem with ../ and Absolute Paths

Attempting to use ../ or providing an absolute path doesn’t resolve the issue. Magento still includes the /base/ path before your theme name. This is because the addCss action in the layout XML is called from the base theme, which then prepends its own path.

The Solution: Override the CSS File

To properly add custom CSS to your homepage without the /base/ path, you need to override the CSS file directly in your theme. Here’s how:

  1. Create a Custom CSS File

    In your theme directory (usually located at app/design/frontend/{Vendor}/{Theme}), navigate to the css folder.

    app/design/frontend/{Vendor}/{Theme}/css
    

    Create a new file, e.g., custom.css.

  2. Add Your Custom Styles

    Open the custom.css file and add your custom CSS rules:

    /* Add your custom styles here */
    body {
        background-color: #f0f0f0;
    }
    
  3. Include the CSS File in Magento

    Back in your theme directory, navigate to the local.xml layout update file located under app/design/frontend/{Vendor}/{Theme}/layout.

    Open or create this file and add the following XML code inside the <layout> tags:

    <layout version="1.0">
      <update handle="default"/>
      <!-- Add a new block for your custom CSS -->
      <block type="core/text_links" template="your/theme/head.phtml"/>
    </layout>
    
  4. Create the Head.phtml Template

    In your theme directory, navigate to template/page/html/ and create a new file called head.phtml.

    Open this file and add the following PHP code:

    <?php echo $this->getCssLink('custom.css', 'skin/frontend/your/theme/css/custom.css'); ?>
    

    This uses Magento’s built-in getCssLink function to include your custom CSS file without any additional paths.

Conclusion

Adding custom CSS to your Magento homepage requires manual intervention in the theme structure itself. By creating a new CSS file and including it directly in your theme, you can override the default styles and avoid the unwanted /base/ path.

This approach ensures that your custom styles are applied correctly and don’t interfere with the base theme’s styling rules. It also provides a clean and organized way to manage your theme’s CSS files.

Remember to always test your changes thoroughly after making modifications in your theme structure or layout XML files.

For more advanced theming tips, consider visiting Laravel Company. We provide comprehensive guides on Magento development best practices.

Themes Configuration Errors

Our network