HTML Minifier Next 5, a Quick Upgrade Guide

Published on Feb 2, 2026, filed under tools, development, html, performance, optimization. (Share this post, e.g., on Mastodon.)

HTML Minifier Next merged with and continues as HTML Minifier, so this post relates to HTML Minifier’s history as well.

The next major release of HTML Minifier Next (HMN) just shipped, and contrary to previous major releases, this one comes with quite a few breaking DX and UX improvements.

To make it easier to work through the breaking changes, here’s a quick checklist:

• File extensions: If you do not limit the file types passed to HMN and you use HMN on files other than .html, .htm, .xhtml, or .shtml, you need to either enable the specific file types you use, or enable all file types (fileExt: "*" or --file-ext='*').

• “HTML 5” mode: If you explicitly used the html5 option (html5 or --no-html5), you should remove it—this mode is always on now and cannot be disabled.

• Sorting by class names: If you sort by class names, you need to rename the parameter to use the plural (sortClassNames or --sort-class-names).

• URL minification configuration: If you use a custom configuration for minifyURLs, you need to remove unsupported properties (only site is accepted with the updated configuration).

Depending on your preferences:

• Presets: If you care about the output of presets, check the output and explicitly enable missing or disable unwanted settings (the presets were optimized for an improved—though opinionated—starter and expert experience).

• Auto-generated tags: If you rely on certain tags that were inserted in the past, you need to enable includeAutoGeneratedTags (includeAutoGeneratedTags: true or --include-auto-generated-tags).

For additional details, please check the changelog. If you run into any problems, please file an issue.

The update contains a few more improvements around security, performance, and developer experience, and should form an even better foundation to extend HMN further.

Stay tuned—and if you like the project as a powerful HTML optimization tool, spread the word and consider supporting the work on it! Thanks!

About Me

I’m Jens (long: Jens Oliver Meiert), and I’m an engineering lead, guerrilla philosopher, and indie publisher. I’ve worked as a technical lead and manager at various companies (e.g., Google); I’m an active web and tool developer (code optimization, digital defense), a contributor to web standards (like HTML, CSS, WCAG), and a book author (O’Reilly, dxsrc). You’ll like my work if you value principled, pragmatic problem-solving. Let’s connect.