npm / postcss-loader
postcss-loader
What changed in postcss-loader 3 to 8, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-23.
21 breaking1 deprecations2 new APIs and options1 performance3 behavior and defaults6 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initpostcss-loader 82 changes
Breaking changes 1
The minimum supported Node.js version is now 18.12.0.
Fixes and other changes 1
Updates the peer dependency to support @rspack/core v2.
postcss-loader 71 changes
Breaking changes 1
The minimum supported Node.js version is 14.15.0.
postcss-loader 62 changes
Breaking changes 2
The minimum supported Node.js version is now 12.13.0.
The loader checks PostCSS as a project dependency.
postcss-loader 51 changes
Breaking changes 1
The minimum supported webpack version is now 5.
postcss-loader 424 changes
Breaking changes 14
The config option no longer supports Object values.
The Function notation argument now contains file, mode, and webpackLoaderContext.
The config.ctx option was removed.
The config.path option was removed.
The exec option was renamed to execute.
The ident option is no longer needed for the loader.
The loader now outputs only CSS; use css-loader, file-loader, or raw-loader to inject code into the bundle.
The minimum supported Node.js version is now 10.13.
postcss is now a peer dependency and must be installed by users.
PostCSS plugins, syntax, parser, and stringifier options move under postcssOptions.
The default sourceMap value now depends on the compiler.devtool option.
The inline value is no longer supported; use map with inline: true and annotation: false instead.
The minimum supported webpack version is now 4.
The config's loader context was renamed from webpack to webpackLoaderContext.
Deprecations 1
Object syntax for the plugin option is soft deprecated; migrate to Array syntax.
New APIs and options 1
A message API was added for emitting assets.
Performance 1
The loader can reuse an AST from other loaders.
Behavior and default changes 3
Config and loader options can be used together; loader options take precedence and plugins are merged.
postcssOptions can now be a Function.
Source maps now contain absolute paths in their sources.
Fixes and other changes 4
The default export for plugins was fixed.
Mutations of loader options and config are avoided.
The map option from loader options and config is now respected.
Compatibility with webpack 5 was fixed.
postcss-loader 34 changes
Breaking changes 2
Requires Node.js version 6.0.0 or newer.
Emits warnings as instances of Error.
New APIs and options 1
Adds an AST version to meta.ast.
Fixes and other changes 1
Improves ValidationError messages for options.