# What changed in postcss-url

> 14 changes in postcss-url 6 to 10 from its official release notes, upgrade guides and advisories: 6 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-26. HTML: https://unstale.sh/npm/postcss-url/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## postcss-url 10

### Breaking changes

- Added support for PostCSS 8. (9.0.0, 10.0.0) — [release notes](https://github.com/postcss/postcss-url/blob/HEAD/CHANGELOG.md), [release notes](https://github.com/postcss/postcss-url/releases/tag/10.0.0)

### Fixes and other changes

- Fixed path resolution when to/from paths match. (10.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/10.0.0)

## postcss-url 9

### Fixes and other changes

- The Async API was fixed. (9.0.0) — [release notes](https://github.com/postcss/postcss-url/blob/HEAD/CHANGELOG.md)

## postcss-url 8

### Breaking changes

- The required Node.js version changed; the notes do not specify the new version. (8.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/8.0.0)

## postcss-url 7

### New APIs and options

- Added support for PostCSS 6. (7.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v7.0.0)

## postcss-url 6

### Breaking changes

- The arguments passed to the custom url callback changed. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)
- filter now matches by asset path relative to the project (process.cwd). (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)
- The hash function changed to xxhash. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)
- Without maxSize, _inline_ no longer processes the callback. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)

### New APIs and options

- The _copy_ option now accepts a basePath parameter. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)
- Options for postcss-url can now be provided as an array. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)

### Behavior and default changes

- Multiple basePath values can now be provided as an array. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)
- _copy_ can work without the postcss to option, but assetPath is required. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)

### Tooling

- Changed from ES5 to ES6. (6.0.0) — [release notes](https://github.com/postcss/postcss-url/releases/tag/v6.0.0)