Skip to content


Repository files navigation

UnusedWebpackPlugin CircleCI

A webpack plugin to find unused modules/source files.



npm i --dev unused-webpack-plugin


const path = require('path');
const UnusedWebpackPlugin = require('unused-webpack-plugin');

module.exports = {
  // webpack configuration
  plugins: [
    new UnusedWebpackPlugin({
      // Source directories
      directories: [path.join(__dirname, 'src')],
      // Exclude patterns
      exclude: ['*.test.js'],
      // Root directory (optional)
      root: __dirname,


  • directories : array of directories where to look for unused source files.
  • exclude : array of exclude patterns when looking for unused source files.
  • root : root directory that will be use to display relative paths instead of absolute ones (see below)
  • failOnUnused: whether or not the build should fail if unused files are found (defaults to false)
  • useGitIgnore: whether or not to respect .gitignore file (defaults to true)

With root

With root

Without root

Without root


If you're not using webpack, check out remnants.