How to Call Custom JS File in PHTML in Magento 2

Magento 2 uses an asynchronous approach to load the JAVASCRIPT file in a page. Magento 2 achieve this approach using require JS library. Magento 2 developers often need to call custom JS file in a particular PHTML file.

Developers often makes mistake in call custom JS file in PHTML. Many developers directly add a JS file in the head section. That leads to JS errors in the browser console. Today we will see how to call custom JS file in PHTML the right way.

Call Custom JS File in PHTML in Magento 2

Let’s say you want to add your custom JS in the category page list.phtml file in your theme. To do so, you need to follow the below steps to call a custom JS file in PHTML in Magento 2.

Step 1: Create a JS file custom.js under app/design/frontend/Vendor/Theme/web/js directory.

    ], function($){
        "use strict";
       return function custom(config, element) {
         alert('My Custom JS');

Step 2: Add alias in theme’s requirejs-config.js file under app/design/frontend/Vendor/Theme directory.

var config = {
map: {
        '*': {
            custom: 'js/custom'

Step 3: Call custom JS file in PHTML by adding below code in list.phtml file.

    require(['jquery', 'custom'], function($, custom) {

By adding this code insider your PHTML, you are telling Magento that whenever list.phtml file executed, add custom.js file in the head section.

I hope this post will help you. Feel free to add a comment for any query. If you want to override core JS file insider your theme then please check this post.

Want to ask a question or leave a comment?

Leave a Comment

(1 Comment)

  • Schoayb

    Does the name of function, the alias, and file name should be same…?

    Can you please add an example with multiple functions in custom.js and ways to call them from phtml file in fronend/adminhtml custom theme…?
    Also how can we use Ajax URL in custom.js that we can have in its phtml?
    PLease guide

  • All the comments are goes into moderation before approval. Irrelevant comment with links directly goes to spam. Your email address will not be published.

    Was this post helpful? Please support Us!

    Follow us on twitter or Like us on facebook.


    To Avoid Spam Downloads, We Want Your Email

    We will send you download link right
    away. Please submit form below.

    Increase Your
    Magento 2

    Get Weekly Tutorial
    to your Inbox
    Subscribe Me
    Subscribe Here