vite-plugin-html-minifier-terser

3.8.0 verified Mon Apr 27 auth: no javascript

Vite plugin that minifies HTML output during the build phase using html-minifier-terser. Version 3.8.0 released in 2025, maintained actively, ships TypeScript types. Configure all html-minifier-terser options directly. Differentiates from similar plugins by using the terser fork of html-minifier for better compatibility with modern HTML5. Commonly used to reduce HTML file size by removing whitespace, quotes, and comments.

Common errors

error Error: Cannot find module 'vite-plugin-html-minifier-terser' ↓

cause Package not installed or missing dependency.

fix

Run 'npm install vite-plugin-html-minifier-terser --save-dev'

error TypeError: htmlMinifierTerser is not a function ↓

cause Using named import instead of default import.

fix

Use 'import htmlMinifierTerser from ...' (no curly braces)

Warnings

gotcha Plugin only minifies during build, not in dev mode. ↓

fix Use for production builds only; no workaround for dev.

gotcha Options are passed directly to html-minifier-terser; refer to its docs. ↓

fix Check html-minifier-terser documentation for all valid options.

Install

npm install vite-plugin-html-minifier-terser

yarn add vite-plugin-html-minifier-terser

pnpm add vite-plugin-html-minifier-terser

Imports

default export

wrong

import { htmlMinifierTerser } from 'vite-plugin-html-minifier-terser'

correct

import htmlMinifierTerser from 'vite-plugin-html-minifier-terser'

The package uses a default export, not a named export.

CommonJS require

wrong

const htmlMinifierTerser = require('vite-plugin-html-minifier-terser')

correct

const htmlMinifierTerser = require('vite-plugin-html-minifier-terser').default

CommonJS users must access the default export via .default due to ESM interop.

TypeScript import
```
import htmlMinifierTerser from 'vite-plugin-html-minifier-terser'
```
Types are included; no separate @types package needed.

Quickstart

Configures vite-plugin-html-minifier-terser with common minification options in Vite's config file.

// vite.config.ts
import { defineConfig } from 'vite';
import htmlMinifierTerser from 'vite-plugin-html-minifier-terser';

export default defineConfig({
  plugins: [
    htmlMinifierTerser({
      removeComments: true,
      collapseWhitespace: true,
      removeAttributeQuotes: true,
      minifyCSS: true,
      minifyJS: true,
    }),
  ],
});