Get A Quote

How To Add The Custom jQuery File Which Depends On jQuery in Magento 2?

How To Add The Custom jQuery File Which Depends On jQuery in Magento 2?

Today, in this digital era the importance of a high-performing websites cannot be neglected. The website should load quickly with all the elements and functionality as it is one of the major conversion triggers. For Magento2 websites, that include JavaScript files, need a right JavaScript loader to load the files quickly & boost the performance. In Magento2, this function is performed by RequireJS.

RequireJS is a basic loader that makes the loading of JavaScript files simple and easy in modular programming. The functionalities are divided into different modules and RequireJS basically manages dependencies between different JavaScript files; hence RequireJS is an ideal tool to gather and manage different JS files from all modules as this enhances the speed and quality of your code.

RequireJS JavaScript loader is considered an ideal framework for Magento2 because of following reasons:

  • A big application is filled with many JavaScript files and each script needs to be addressed with a request. RequireJS easily deals with this issue.
  • You need to place the files in the same order in which they will be called, i.e. the framework will load the dependent files first and later the other.
  • The JS file is included in the body, which accelerates the load time of the page.
  • The RequireJS framework avoids uneasy conflicts created due to development.

So, if you want to add a custom JavaScript file into Magento2 you need to include a RequireJS file to make the process and code quality better.

Here are the steps to add a custom JavaScript file which is dependent on JavaScript library to Magento2 website:

Step 1: Add your jQuery or JS.

Add your JS file inside of the theme directory like: <theme_dir>/web/js/Your_custome.js

Step 2: Create Require Configure JS file.

Configure JS file

Create the “requirejs-config.js” in your root directory of theme like: <theme_dir>/requirejs-config.js

Add the following code in “requirejs-config.js” file.

In this:

Here the function “map” is to map your file with the alias name of your custom JS file provided.

In the above example, “Any_name_for_JS” is basically the alias of the custom JS file “Your_custome.js”. While, the functionality of the “shim” is to add a dependency of other JS library files.

Here, “Your_custome.js” file relies on the main jQuery library, hence you need to add the following line for the shim function.

“Magento_Theme/js/Your_custome.js”: [jquery”]

If you have various other dependencies of jQuery files or libraries, you can add them by “comma” in the code.

Step 3: Add the JS in PHTML File


The last step is to add the custom JavaScript file to PHTML file of the theme in order to implement the code on the webpage with the following code format.

Still confused & wondering about methods to implement JavaScript files in Magento 2? Hire Magento developers for any kind of Magento2 development services.

Rate This Post

4.0/5 Based on 12 reviews
Read by2487
Avatar photo

Written by Jeegnasa Mudsa

Jeegnasa Mudsa is Executive Director at CMARIX InfoTech. a leading eCommerce development company with 15+ years experience. A blend of true Engineer and HR power house to run the Company Operations. Creative Director with in-depth experience of Technology and Human Resource domain. A people person and a compassionate Mother.

Hire Dedicated Developers

Ready to take your business to new heights? Our team of dedicated developers is here to make your dreams a reality!



    Have an Interesting Project?
    Let's talk about that!