Move JavaScript files to the bottom in Magento

Move JavaScript files to the bottom in Magento

July 14, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Move JavaScript files to the bottom in Magento

Moving JavaScript Files to the Bottom of Magento Pages

As an experienced developer, I often see merchants wanting to optimize their Magento stores for better page load times. Moving JavaScript files to the bottom of the page is a common practice that can significantly improve your site’s performance.

Why Move JavaScript to the Bottom?

Moving JavaScript files to the bottom ensures they are loaded after the HTML content has finished loading, which reduces the rendering time and makes your pages appear faster to users. This technique, known as “async” or “deferred” loading, allows the browser to prioritize the HTML and CSS before running the JavaScript code.

The Current Setup

In Magento’s default page.xml file, you’ll find the <head> block that includes all the JavaScript files:

<default>
    <block type="page/html_head" name="head">
        <action method="addJs">...</action>
        <!-- More JavaScript actions -->
    </block>
</default>

As you can see, all the JavaScript files are added to the head using the addJs action.

The Incorrect Approach

The approach suggested in your question is incorrect because it completely removes all CSS and JavaScript links from the <head> section. This would break most of your site’s functionality.

<reference name="head">
    <action method="unsetData" .../>
    <!-- Re-adding one CSS link -->
</reference>

The Correct Approach

To correctly move the JavaScript files to the bottom, you need to use Magento’s built-in “deferred” feature. Here’s how:

  1. Open your page.xml file.
  2. Locate the <head> block.
  3. Instead of using addJs, wrap your JavaScript actions inside a new block with type="page/html_defer_js".

Here’s an example of moving one JavaScript file to the bottom:

<default>
    <block type="page/html_head" name="head">
        <!-- Other JavaScript links -->
    </block>

    <block type="page/html_defer_js" name="deferred_javascripts">
        <action method="addJs">...</action>
    </block>
</default>

In this example, the prototype/prototype.js file is moved to a new “defer” block. The browser will load its content after the HTML has finished parsing.

Conclusion

Moving JavaScript files to the bottom of your Magento pages is crucial for improving page speed and user experience. However, it’s essential to use the correct approach that doesn’t break your site’s functionality.

For more detailed information on optimizing Magento performance, check out our comprehensive guide on Magento Performance Optimization.

Remember, performance tuning is an iterative process. Always monitor your site’s speed metrics using tools like Google PageSpeed Insights and GTmetrix to verify the effectiveness of your changes.

Happy optimizing!

Performance Themes JavaScript

Our network