{"id":20127,"library":"imagemin-webpack-plugin","title":"imagemin-webpack-plugin","description":"Webpack plugin that compresses images using imagemin. Current stable version is 2.4.2, with v3.0.0-beta.0 available. It integrates imagemin into the Webpack build process, allowing automatic image optimization. Key differentiators: simple configuration, support for external images, size limits, and caching. Ships TypeScript types. Active development with a beta for v3.0.","status":"active","version":"2.4.2","language":"javascript","source_language":"en","source_url":"https://github.com/Klathmon/imagemin-webpack-plugin","tags":["javascript","typescript"],"install":[{"cmd":"npm install imagemin-webpack-plugin","lang":"bash","label":"npm"},{"cmd":"yarn add imagemin-webpack-plugin","lang":"bash","label":"yarn"},{"cmd":"pnpm add imagemin-webpack-plugin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core image compression library","package":"imagemin","optional":false}],"imports":[{"note":"Default export; use default import or require with default property.","wrong":"const { ImageminWebpackPlugin } = require('imagemin-webpack-plugin')","symbol":"ImageminWebpackPlugin","correct":"import ImageminWebpackPlugin from 'imagemin-webpack-plugin'"},{"note":"CommonJS require must use .default for this package.","wrong":"const ImageminWebpackPlugin = require('imagemin-webpack-plugin')","symbol":"ImageminWebpackPlugin","correct":"const ImageminWebpackPlugin = require('imagemin-webpack-plugin').default"},{"note":"Type import available for TypeScript users.","wrong":"","symbol":"WebpackPluginInstance","correct":"import type { WebpackPluginInstance } from 'imagemin-webpack-plugin'"}],"quickstart":{"code":"import ImageminWebpackPlugin from 'imagemin-webpack-plugin';\nimport { Configuration } from 'webpack';\n\nconst config: Configuration = {\n  entry: './src/index.js',\n  output: {\n    path: 'dist',\n    filename: 'bundle.js',\n  },\n  plugins: [\n    new ImageminWebpackPlugin({\n      test: /\\.(jpe?g|png|gif|svg)$/i,\n      pngquant: { quality: '65-80' },\n      optipng: { optimizationLevel: 3 },\n      jpegtran: { progressive: true },\n    }),\n  ],\n};\n\nexport default config;","lang":"typescript","description":"Minimal webpack configuration using the plugin to compress images with pngquant, optipng, and jpegtran."},"warnings":[{"fix":"Review https://github.com/Klathmon/imagemin-webpack-plugin/issues/90","message":"v3.0.0-beta.0 may have breaking changes; check changelog before upgrading.","severity":"breaking","affected_versions":">=3.0.0-beta.0"},{"fix":"Upgrade to v2.3.0 or later to use filename option","message":"The 'filename' option for externalImages was added in v2.3.0; older versions ignored it.","severity":"deprecated","affected_versions":"<2.3.0"},{"fix":"Use yarn or manually upgrade tunnel-agent","message":"npm users may not get the tunnel-agent fix from v2.1.2 because npm ignores resolutions field.","severity":"gotcha","affected_versions":"2.1.2"},{"fix":"Upgrade to v2.1.0 or later for Webpack 4","message":"Webpack 4 support added in v2.1.0; earlier versions do not support Webpack 4.","severity":"breaking","affected_versions":"<2.1.0"},{"fix":"Clear cache directory if upgrading from <=2.1.0","message":"Cache hashing changed in v2.1.1: now hashes file contents instead of filenames.","severity":"gotcha","affected_versions":">=2.1.1"},{"fix":"Upgrade to v2.4.0 or later","message":"v2.4.0 bumped imagemin and plugins; older versions may have security issues.","severity":"deprecated","affected_versions":"<2.4.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Use `import ImageminWebpackPlugin from 'imagemin-webpack-plugin'` (default import)","cause":"Incorrect import syntax","error":"Error: Cannot find module 'ImageminWebpackPlugin'"},{"fix":"Use `const ImageminWebpackPlugin = require('imagemin-webpack-plugin').default`","cause":"CommonJS require without .default","error":"TypeError: ImageminWebpackPlugin is not a constructor"},{"fix":"Run `npm install imagemin-webpack-plugin --save-dev`","cause":"Package not installed","error":"Module not found: Error: Can't resolve 'imagemin-webpack-plugin'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}