CopyWebpackPlugin

Copies individual files or entire directories to the build directory.

To begin, you’ll need to install copy-webpack-plugin:

Then add the loader to your webpack config. For example:

webpack.config.js

const CopyPlugin = require('copy-webpack-plugin');
module.exports = {
  plugins: [
    new CopyPlugin([
      { from: 'source', to: 'dest' },
      { from: 'other', to: 'public' },
    ]),
  ],
};

The plugin’s signature:

webpack.config.js

module.exports = {
  plugins: [new CopyPlugin(patterns, options)],
};

Name

Type

Default

Description

Name

from

Type

{String|Object}

Default

undefined

Description

Glob or path from where we сopy files.

Name

Type

{String}

Default

undefined

Description

Output path.

Name

context

Type

{String}

Default

options.context ||compiler.options.context

Description

A path that determines how to interpret the from path.

Name

Type

{String}

Default

undefined

Description

Determinate what is to option - directory, file or template.

Name

test

Type

{RegExp}

Default

undefined

Description

Pattern for extracting elements to be used in to templates.

Name

Type

{Boolean}

Default

false

Description

Overwrites files already in compilation.assets (usually added by other plugins/loaders).

Name

ignore

Type

{Array}

Default

[]

Description

Globs to ignore files.

Name

Type

{Boolean}

Default

Description

Removes all directory references and only copies file names.

Name

transform

Type

{Function|Promise}

Default

undefined

Description

Allows to modify the file contents.

Name

Type

{Boolean|Object}

Default

false

Description

Enable transform caching. You can use { cache: { key: 'my-cache-key' } } to invalidate the cache.

Name

transformPath

Type

{Function|Promise}

Default

undefined

Description

Allows to modify the writing path.

from

Type: String\|Object Default: undefined

Glob or path from where we сopy files. Globs accept minimatch options.

You can defined from as Object and use the .

⚠️ Don’t use directly \\ in from (i.e path\to\file.ext) option because on UNIX the backslash is a valid character inside a path component, i.e., it’s not a separator. On Windows, the forward slash and the backward slash are both separators. Instead please use / or path methods.

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      'relative/path/to/file.ext',
      '/absolute/path/to/file.ext',
      'relative/path/to/dir',
      '/absolute/path/to/dir',
      '**/*',
      { glob: '**/*', dot: false },
    ]),
  ],
};

to

Type: String Default: undefined

Output path.

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      { from: '**/*', to: 'relative/path/to/dest/' },
      { from: '**/*', to: '/absolute/path/to/dest/' },
    ]),
  ],
};

context

Type: String Default: options.context|compiler.options.context

A path that determines how to interpret the path.

⚠️ Don’t use directly \\ in context (i.e path\to\context) option because on UNIX the backslash is a valid character inside a path component, i.e., it’s not a separator. On Windows, the forward slash and the backward slash are both separators. Instead please use / or path methods.

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/*.txt',
        to: 'dest/',
        context: 'app/',
    ]),
  ],
};

toType

Type: String Default: undefined

Determinate what is to option - directory, file or template. Sometimes it is hard to say what is to, example path/to/dir-with.ext. If you want to copy files in directory you need use dir option. We try to automatically determine the type so you most likely do not need this option.

Name

Type

Default

Description

Name

'dir'

Type

{String}

Default

undefined

Description

If from is directory, to has no extension or ends in '/'

Name

'file'

Type

{String}

Default

undefined

Description

If to has extension or from is file

Name

'template'

Type

{String}

Default

undefined

Description

If to contains

'dir'

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'path/to/file.txt',
        to: 'directory/with/extension.ext',
        toType: 'dir',
      },
    ]),
  ],
};

'file'

webpack.config.js

'template'

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/',
        to: 'dest/[name].[hash].[ext]',
        toType: 'template',
      },
    ]),
  ],
};

test

Pattern for extracting elements to be used in to templates.

Defines a {RegExp} to match some parts of the file path. These capture groups can be reused in the name property using [N] placeholder. Note that [0] will be replaced by the entire path of the file, whereas [1] will contain the first capturing parenthesis of your {RegExp} and so on…

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: '*/*',
        to: '[1]-[2].[hash].[ext]',
        test: /([^/]+)\/(.+)\.png$/,
      },
    ]),
  ],
};

force

Type: Boolean Default: false

Overwrites files already in compilation.assets (usually added by other plugins/loaders).

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/**/*',
        to: 'dest/',
        force: true,
      },
    ]),
  ],
};

ignore

Type: Array Default: []

Globs to ignore files.

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/**/*',
        to: 'dest/',
        ignore: ['*.js'],
      },
    ]),
  ],
};

flatten

Type: Boolean Default: false

Removes all directory references and only copies file names.

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        to: 'dest/',
        flatten: true,
      },
    ]),
  ],

transform

Type: Function|Promise Default: undefined

Allows to modify the file contents.

{Function}

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/*.png',
        to: 'dest/',
        transform(content, path) {
          return optimize(content);
        },
      },
    ]),
  ],
};

{Promise}

webpack.config.js

cache

Type: Boolean|Object Default: false

Enable/disable transform caching. You can use { cache: { key: 'my-cache-key' } } to invalidate the cache. Default path to cache directory: node_modules/.cache/copy-webpack-plugin.

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/*.png',
        to: 'dest/',
        transform(content, path) {
          return optimize(content);
        },
        cache: true,
      },
    ]),
  ],
};

transformPath

Type: Function|Promise Default: undefined

Allows to modify the writing path.

⚠️ Don’t return directly \\ in transformPath (i.e path\to\newFile) option because on UNIX the backslash is a valid character inside a path component, i.e., it’s not a separator. On Windows, the forward slash and the backward slash are both separators. Instead please use / or path methods.

{Function}

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/*.png',
        to: 'dest/',
        transformPath(targetPath, absolutePath) {
          return 'newPath';
        },
      },
    ]),
  ],
};

{Promise}

webpack.config.js

module.exports = {
  plugins: [
    new CopyPlugin([
      {
        from: 'src/*.png',
        to: 'dest/',
        transformPath(targePath, absolutePath) {
          return Promise.resolve('newPath');
        },
      },
    ]),
  ],
};

Options

Name

Type

Default

Description

Name

Type

{String}

Default

'warn'

Description

Level of messages that the module will log

Name

ignore

Type

{Array}

Default

[]

Description

Array of globs to ignore (applied to from)

Name

Type

{String}

Default

compiler.options.context

Description

A path that determines how to interpret the from path, shared for all patterns

Name

copyUnmodified

Type

{Boolean}

Default

false

Description

Copies files, regardless of modification when using watch or webpack-dev-server. All files are copied on first build, regardless of this option

logLevel

This property defines the level of messages that the module will log. Valid levels include:

• trace
• debug
• info
• warn (default)
• error
• silent

Setting a log level means that all other levels below it will be visible in the console. Setting logLevel: 'silent' will hide all console output. The module leverages webpack-log for logging management, and more information can be found on its page.

webpack.config.js

module.exports = {
  plugins: [new CopyPlugin([...patterns], { logLevel: 'debug' })],
};

ignore

Array of globs to ignore (applied to from).

webpack.config.js

module.exports = {
  plugins: [new CopyPlugin([...patterns], { ignore: ['*.js', '*.css'] })],
};

context

A path that determines how to interpret the from path, shared for all patterns.

webpack.config.js

module.exports = {
  plugins: [new CopyPlugin([...patterns], { context: '/app' })],
};

copyUnmodified

Copies files, regardless of modification when using watch or webpack-dev-server. All files are copied on first build, regardless of this option.

webpack.config.js

Please take a moment to read our contributing guidelines if you haven’t yet done so.

MIT