Retrieve Magento store's base url in javascript

Retrieve Magento store's base url in javascript

August 25, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Retrieve Magento store's base url in javascript

Retrieving Magento Store Base URL in JavaScript

If you’re building a reusable extension for Magento that requires the base URL during AJAX calls within your JavaScript code, determining the store’s base URL might appear challenging at first glance. Let me guide you through the best practices to achieve this without modifying templates or hardcoding values.

The Native Mage.baseUrl Property

You’d expect a property like Mage.baseUrl to be readily available in your JavaScript code, given that Magento heavily uses AJAX for many core functionalities. However, I couldn’t find any official documentation supporting the existence of such a global variable out-of-the-box.

Alternative Approaches: Programmatic and Static

Method 1: Programmatic Injection via Layout XML

One elegant way to inject the base URL into your JavaScript code is through layout XML files. You can create a new file under app/design/frontend/<your_package>/<your_theme>/layout/default.xml with the following content:

<head>
    <script type="text/javascript">
        var BASE_URL = '<?php echo Mage::getBaseUrl(); ?>';
    </script>
</head>

This code snippet defines a new JavaScript variable BASE_URL and assigns it the value of Magento’s base URL. Remember to replace <your_package> and <your_theme> with your actual package and theme names.

Method 2: Static Configuration

Another approach is to store the base URL as a static configuration in your module, which can be accessed from your JavaScript code via an AJAX call. Here’s how you can achieve this:

  1. Add the following configuration file under app/code/local/<Namespace>/<Module>/etc/config.xml:
<config>
    <global>
        <stores>
            <base translate="label">
                <web>
                    <url type="base_url">https://example.com/</url>
                </web>
            </base>
        </stores>
    </global>
</config>

Replace https://example.com/ with the actual base URL of your store.

  1. In your JavaScript file, send an AJAX request to retrieve this configuration value:
var url = '<?php echo Mage::getUrl('adminhtml/your_module/config/getBaseUrl'); ?>';
$.ajax({
    url: url,
    method: 'POST',
}).done(function(response) {
    var baseUrl = response.base_url;
    // Your code using the retrieved base URL
});

Conclusion

While Magento doesn’t provide a built-in Mage.baseUrl property for your JavaScript code, you can easily achieve this by either programmatically injecting the value through layout XML files or by creating an AJAX endpoint to retrieve it from static configuration.

Remember that using inline JavaScript within layout XML files is generally considered better practice than external JavaScript files when dealing with simple values like the base URL. However, always ensure your code remains organized and maintainable.

For further reading on Magento development best practices and extension creation, I recommend exploring Laravel Company’s comprehensive guides.

Happy coding! Let me know if you have any questions or need additional guidance.

Extensions Themes Configuration JavaScript

Our network