Easy Includes
Plugin to Include Javascript or CSS files to Joomla
-
Free download Install it with no checkout
-
One-click updates New releases install from the Joomla administrator
-
Version 2.1 Updated today
-
Works with Joomla 4, 5 and 6
-
PHP 8.1 or later recommended
-
Downloads 10.5K+
- 5.0 rating See the reviews
Features
What can Easy Includes do for you?
Eight feature areas, one install package for Joomla 4, 5 and 6.
-
Files · CDN · Inline
CSS and JS Without Template Edits
- Keep custom assets separateAdd site-relative CSS or JavaScript paths, CDN URLs, or trusted inline code from the plugin settings.
- Per-row controlTurn any file or inline block on or off without deleting it.
-
Defer · Async · Modules
Modern Script Loading
- Choose how scripts runUse Normal, Defer, or Async loading for each JavaScript file.
- CDN-ready optionsSupport ES modules, nomodule fallbacks, crossorigin, and Subresource Integrity hashes.
-
Off · Auto · Aggressive
Cache Busting That Makes Sense
- Auto modeUses the local file change time so browsers pick up updates after you edit a file.
- Aggressive modeAdds a timestamp on every request. Keep it for testing only.
-
Groups · Components · URLs
Skip Pages That Should Stay Clean
- Exclusions built inSkip selected user groups, components such as com_users, or URL path fragments like /checkout.
- Front-end by defaultAdministrator loading stays off unless you turn it on.
-
Screen · Print · Custom
CSS Media When You Need It
- Target the right screensApply stylesheets to all, screen, print, or a custom media query such as (max-width: 768px).
- Inline styles tooThe same media options work for inline CSS blocks.
-
Validation · Logging
Safer Paths and Clear Debugging
- Path checksRejects directory traversal and dangerous URL schemes before assets are registered.
- Debug loggingOptional log notes for skipped exclusions and failed rows while you troubleshoot.
-
Service Provider · WAM
Built for Joomla 4, 5, and 6
- Modern plugin structureNamespaced class, DI service provider, SubscriberInterface, and language files.
- Web Asset ManagerRegisters styles and scripts the Joomla way so templates and other extensions stay compatible.
-
Settings Preserved
Upgrade Friendly from 1.5
- Keep your rowsExisting files and inline blocks carry forward with the same core parameter names.
- Clearer controlsOld Head/Body choices map to Normal or Defer, and obsolete IE conditional comments are removed.
Changelog
What's new
7 releases since version 1.1. Updates install from the Joomla admin with a valid licence.
- Runs on Joomla 5 and 6 with the Behaviour Backward Compatibility plugins disabled
- Group exclusions use the current user identity API
- Added per-row Enable switches for files and inline code
- Added ES module, nomodule, crossorigin, and SRI integrity options for scripts
- Added custom CSS media queries for files and inline styles
- Added Off, Auto, and Aggressive cache busting modes
- Added optional administrator loading and debug logging
- Added exclusions for user groups, components, and URL path fragments
- Added language files and a reproducible 2.0 install package
- Rebuilt with Joomla 4 / 5 / 6 service provider, namespace, and SubscriberInterface
- Replaced Head/Body load position with Normal, Defer, and Async script loading
- Tightened path validation and basic inline CSS safety checks
- Removed obsolete IE conditional comment settings
- Improved Security - Enhanced path validation and directory traversal protection
- Joomla 4, 5 & 6 Compatible - Full support for latest Joomla versions
- Joomla 3.x Support Discontinued - Plugin no longer supports Joomla 3.x
- Modern PHP 8.0+ Support - Updated to use modern PHP syntax and features
- Subform Interface - Replaced textarea fields with subforms for better file and inline code management
- WebAssetManager Integration - Uses Joomla's WebAssetManager for optimal asset loading and caching
- Advanced File Management - Support for file type, load position, script attributes, media queries, and conditional comments
- Priority System - Added priority management for controlling load order of files and inline code
- Cache Busting - Added option to enable cache busting for file URLs
- Inline Code Management - Separate subform for managing inline CSS and JavaScript/jQuery code
- Code Optimization - Refactored code with better structure and improved error handling
- Supports Joomla 5 without Backward Compatiblity Plugin
- Single file installation for both Joomla 3 and Joomla 4
- Supports Joomla 4
Show 1 older release
- Joomla Update System Integrated
Docs & setup
Get up and running fast
Written guides for installing and configuring Easy Includes, from first setup to the options that matter.
- Installation stepsOne install zip for Joomla 4, 5 and 6, installed from System, Install, Extensions.
- Configuration optionsThe settings in the guide, from first setup to the options that matter.
- Practical usage tipsShort examples you can adapt to your site.
Why buy here
Why JoomlaX
- Built, maintained and supported by one team Every product sold on JoomlaX is developed, maintained and supported by Infyways, building Joomla solutions since 2010.
- Ready for Joomla 4, 5 and 6 118 extensions support Joomla 5 and 6, and 114 support Joomla 4. Each product page lists the versions it works with.
- One-click Joomla updates Regular updates and feature improvements for licensed customers, delivered straight to your Joomla admin.
- Support from the developers Tickets go straight to the developers. First replies within 24 business hours.
All-access bundle
Unlock every JoomlaX extension in one plan
Get all 125 extensions, new releases, ongoing updates and full-time support. Bought one by one, a year of updates for every extension costs over $4,700.
-
Basic
Ideal for small projects and personal sites
$249/ 6 months
Save 91% · $2,900+ value
- Access to 125 extensions
- Access to new extensions during period
- 3 websites license
- 6 months support and updates
- Unlimited downloads and domain activations
- Full-time expert technical support
30-day money-back guarantee
-
Most popular
Premium
Best for growing businesses and web agencies
$349/ 1 year
Save 92% · $4,700+ value
- Access to 125 extensions
- Access to new extensions during period
- 5 websites license
- 1 year support and updates
- Unlimited downloads and domain activations
- Priority full-time technical support
30-day money-back guarantee
-
Developer
For professional developers and multi-client agencies
$749/ one-time
Pay once · keep forever
- Access to 125 extensions
- Access to all future new extensions
- Unlimited websites license
- Lifetime support and updates
- Unlimited downloads and domain activations
- VIP priority full-time technical support
30-day money-back guarantee
FAQ
Questions about Easy Includes
Still unsure? Our support team is one ticket away.
Which Joomla versions does Easy Includes 2.0 support?
Easy Includes 2.0 supports Joomla 4, Joomla 5, and Joomla 6. PHP 8.1 or later is recommended.
Do I need to edit my template?
No. Add CSS and JavaScript from System - Easy Includes. The plugin registers assets through Joomla Web Asset Manager.
What path format should I use?
Use a site-relative path such as templates/cassiopeia/css/custom.css, or a full https:// CDN URL. Do not use .. path segments.
What is the difference between Defer and Async?
Defer downloads the script and runs it after HTML parsing. Async downloads in parallel and runs as soon as it is ready, which may change order relative to other scripts.
Which cache busting mode should I use?
Use Off for stable production URLs, Auto after editing local files, and Aggressive only while testing because it changes the URL on every request.
Can I stop assets on some pages?
Yes. Use Exclusions for user groups, component names such as com_content, or URL path fragments such as /checkout.
Does it load in the administrator?
Not by default. Turn on Enable in Administrator only if you intentionally want the same assets in the admin area.
Is inline JavaScript safe?
Inline JavaScript is trusted administrator input and is not HTML-filtered. Only trusted admins should add it. Inline CSS rejects a few obvious dangerous patterns.
What happens to my 1.5 settings after upgrade?
File and inline rows are kept. Open the plugin, review Script Loading and Advanced options, then save. Old Body load position values map to Defer.
Where can I get support?
Visit support.joomlax.com. Include your Joomla and PHP versions, plugin settings, page URL, and any log messages when Debug Logging is enabled.
Help from the people who built it
- Documentation Installation, configuration and usage guides for this extension. Read the docs →
- Support portal Open a ticket with the developers. We reply to your first request within 24 business hours. Open a ticket →
- Live demos Try this extension on a live demo before you buy. Open this demo →
- Support policy What support covers, response times and how to get the fastest answer. Read the policy →