How do I add custom JavaScript to Joomla without editing the template?

Use Easy Includes by JoomlaX: enable the plugin, add a file or CDN row, choose Defer when appropriate, save, and clear cache.

How do I add custom JavaScript with DIY Web Asset Manager?

Put the file in child template media, declare it in joomla.asset.json, call useScript in the template PHP, and clear cache.

What is the Web Asset Manager?

It is Joomla's system for registering and loading CSS/JS with names, dependencies, and attributes so extensions do not step on each other.

Should I still use Document::addScript?

No for new work. Use useScript, registerScript, or registerAndUseScript instead.

Can I add JavaScript to a single Joomla article?

Avoid pasting scripts into article HTML. Prefer a menu-assigned module, an override with registerAndUseScript, or Easy Includes exclusions aimed at that page.

What is the difference between Defer and Async?

Defer runs after HTML parsing and keeps order relative to other deferred scripts. Async runs when ready and may reorder. Prefer Defer for most site UI scripts.

Where should Google Analytics go?

In a consent-controlled script slot, not as always-on custom JS. See the Joomla cookies for visitors guide .

Will Easy Includes work on Joomla 6?

Yes. Easy Includes 2.0 supports Joomla 4, 5, and 6 with Web Asset Manager registration.

How do I stop my script on checkout pages?

With Easy Includes, use exclusions for the checkout URL or shop component. With DIY template assets, load the script only from overrides that are not the checkout view.

How do I remove custom JavaScript from Joomla?

Disable or delete the Easy Includes row, or remove the useScript / registerAndUseScript call and the joomla.asset.json entry, delete the file if unused, then clear Joomla and CDN caches and confirm in Network.

Why do I still see the script after I deleted the file?

Something is still registering it, or a cached HTML/CDN copy remains. Remove the registration, purge caches, and search for a second hard-coded tag.

Where do we start if the template is full of hard-coded scripts?

Request a Joomla upgrade audit , move assets into Easy Includes or a child template, and remove the hard-coded tags.

Joomla

How to add custom JavaScript to Joomla

Add or remove custom JavaScript on Joomla 4, 5, and 6: Easy Includes by JoomlaX, DIY Web Asset Manager, and how to clean up leftover script tags.

Abhilash Sahoo

Sep 22, 202612 min read

Frequently asked questions

Share this article

Joomla

Written by

Abhilash Sahoo

Abhilash Sahoo, with over 16 years of experience, is Founder & CEO of Infyways Solutions. He builds web platforms and eCommerce on Joomla, WordPress, Shopify, Magento, and OpenCart, plus modern stacks like Next.js, React, Node.js, and Python, with AI agents, automation, and headless CMS when products need to scale.

Keep reading

View all

Tell us what you're building. Whether it's a new site, an online store, a mobile app, or something that needs AI under the hood, we'll get back to you within a business day.

Free consultation

No commitment, no pressure

Reply within 24 hours

Usually much faster

How to add custom JavaScript to Joomla

Frequently asked questions

Abhilash Sahoo

Related articles

Choosing the Right CMS: What You Need to Know Before You Decide

Joomla vs WordPress: Equal Comparison for 2026

Joomla .htaccess Guide: SEF, Security, Speed (All Versions)

Have a project in mind? Let's talk about it.

Tell us about your project

Services

AI & Automation

Industries

Company

Technologies