Compatible With: Community 2.0, 2.1, 2.2

Tech Specifications

Current Version:
Stable Build
18 August, 2017
Extensions, Site Optimization, Performance
License Type:
Open Software License 3.0 (OSL-3.0)


Minify HTML including inline CSS and JS to speed up your site. Works with default Magento CSS/JS merger.

Other Extensions by Apptrian


Back to top

Minify HTML CSS JS is a very small and efficient extension. It will minify HTML code including inline CSS and JavaScript code. Merging and Minification of CSS and JavaScript files is already builtin feature of Magento 2 and newer therefore our extension does not influence this functionality in any way. Extension is very easy to install and use. Compatible with FPC and Varnish cache extensions. If there is a serious error in some page code that page will not be minified. Extension will log the error and url of the page where this error occurs so developers can track it down and fix the code.

Minification is the process of removing all unnecessary characters from source code without changing its functionality - e.g. code comments and formatting, removing unused code, using shorter variable and function names, and so on. After minification code is smaller in size that means less bytes will be transmitted from your server to your customer's web browsers which makes your site pages load faster. Beside small speed increase search engines (especially Google) will give you a plus in the SEO department (Search Engine Optimization). So you should definitely Minify your code. Be sure to use a validator to check your page's code before using our extension. You must have error-free HTML code if you want minification to work.


- Easy way to enable or disable HTML Minification.
- Option to set Maximum HTML Minification.
- Cache Compatibility Mode option for HTML minification.
- Option to remove important comments or not.


- Pre Installation Instructions

Do the following Before you install Minify HTML CSS JS extenison!

- If you are using "Expires Header" turn it off temporarily.
- If you are using CDN turn it off temporarily.
- Go to your Magento Admin and enable merging and minification of CSS and JavaScript files:
Stores > Configuration > Advanced > Developer > CSS Settings
Stores > Configuration > Advanced > Developer > JavaScript Settings
Flush and Refresh Magento cache (System > Cache Management)
From a command line execute following command:
php bin/magento setup:static-content:deploy
- Use HTML, CSS, and JS validators to check your website. Warnings can be ignored but errors must be fixed. (Some errors can be ignored like the ones regarding HTML attributes.)
- After you fixed everything only then install and use our extension.

- Installation Instructions

If you purchased extension on Magento Marketplace then unpack .zip file inside app/code/Apptrian/Minify/ directory.

If you purchased extension on our site then unpack .zip file inside your Magento root.

Run following commands on Magento root directory:

php bin/magento module:enable --clear-static-content Apptrian_Minify

php bin/magento setup:upgrade

php bin/magento cache:flush

php bin/magento setup:static-content:deploy

If you do not know how to install extension or you wish a professional to do it for you, we offer additional Installation service for a small fee.

(If you purchase Installation Service please contact us via contact form on our site and state your full name and order ID)

- Configuration

Our extension works out of the box. Only thing you need to do is to enable it in extension configuration. To do this log to your Magento Admin and go to:

Stores > Configuration > Apptrian Extensions > Minify HTML CSS JS

All options are self explanatory and have tooltips for additional information.

After changing options make sure you refresh your Magento cache (System > Cache Management).

This extension is FREE however support is NOT

Please understand that we get more than a few emails almost every day asking for support. In most cases problems are lack of basic Magento knowledge and not reading Installation Instructions. Due to our other projects we do not have time to answer all of them. Because of this we cannot provide free support for our free extensions. However we offer very affordable support options for this extension on our site.


Q: Why after enabling minification my pages are all mangled up / have missing parts?
A: You probably have errors in your HTML/CSS/JS code. One stray tag is enough to cause this behavior. Before you enable minification you must have error free code. Turn minification off, use W3C validator to find errors and fix them.

Q: Why are not all CSS/JS files merged and minified?
A: First of all external(off site) CSS/JS files will not be merged and minified. For example:
Minifying…ork?v=0.0.2000-RC8.41700-1420&lang=en_US could save 2KiB (5% reduction) after compression.
This happens if you use Linkedin button, this file is on Linkedin server not on your server it is their responsibility to minify it, not yours, your Magento installation nor our Minify extension.
Second, all CSS/JS must be properly included in Magento via .xml file (for example page.xml of your theme). Some extensions might hardcode link and script tags into .phtml templates, these files will not be merged by Magento default file merger (Magento does not know about them because they are not properly included) and subsequently will not minify them.

Q: Why Google PageSpeed Insights reports that CSS/JS files are not fully minified? (1)
A: Sometimes it is because gzip compression is turned off on your server. Use your .htaccess file to enable it.

[IfModule mod_deflate.c]
# Compress text, html, javascript, css, xml:
AddOutputFilterByType DEFLATE text/plain text/html text/xml text/css application/xml application/xhtml+xml application/rss+xml application/javascript application/x-javascript

(* Because of html filtering we cannot write exact code on Magento Marketplace. Instead of [ and ] less than and greater than should be used. Visit our site to see it better.)

Q: Why Google PageSpeed Insights reports that CSS/JS files are not fully minified? (2)
A: Sometimes Google PageSpeed Insights will report that CSS/JS files are not fully minified. For example:
Minifying…a/js/6a3cfa142fd20a7dc62423f1c15e4ad9.js could save 648B (1% reduction) after compression.
This is normal. Some of the CSS/JS files/libraries published by Google also have this or similar complaints from Google PageSpeed Insights.
Minifying…/cb=gapi.loaded_0 could save 684B (2% reduction) after compression.
If Google itself cannot satisfy its own Google PageSpeed Insights testing tool, then what chance anyone else has. :-D
Rest assured your files are properly minified, by the tools recommended by Google, so just ignore these types of complaints from Google PageSpeed Insights.

A Word From the Author

Thank you very much for your interest in Minify HTML CSS JS extension. You can rest assured that by choosing this extension you are getting high quality product despite the fact it is free. Same professional approach, dedication and care are invested in this product as if it is paid one. If you find this product useful and want to say "thanks" you can do that by rating it and writing short review about it on Magento Connect. Also you can like, share and follow us on Facebook, Google+, Pinterest, and Twitter.

If you have any questions about extension or Magento in general feel free to contact us.

Release Notes

Back to top


  • Compatible with CE: 2.0 2.1 2.2
  • Stability: Stable Build
  • Description:

    * Compatibility with Magento 2.2


  • Compatible with CE: 2.0 2.1
  • Stability: Stable Build
  • Description:

    * Complete rewrite from the ground up
    + Support for Knockout JavaScript library comments
    + Support for script tags of type="text/x-magento-template"
    + Logging of errors with url where errors occur
    + Compliance with Magento's Extension Quality Program (EQP)
    * Small bug fixed


Back to top
The best place to start if you need help with a specific extension is to contact the developer. All Magento developers have both a contact email and a support email listed.

Q & A

Back to top


Back to top