# What changed in colord

> 7 changes in colord 2 from its official release notes, upgrade guides and advisories: 1 breaking, 1 security, 1 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/npm/colord/

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

## colord 2

### Breaking changes

- Keeps hue within [0, 360) in every color model, changing returned numbers for a small set of colors; toHex() output is unchanged. (2.9.5) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#295)

### Security

- Malformed color strings are rejected in linear time. (2.9.4) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#294), [security advisory](https://github.com/advisories/GHSA-2WM5-Q62R-HMRV)

### New APIs and options

- Adds an optional rgb interpolation mode to mix, tints, tones and shades. (2.10.0) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#2100)

### Performance

- HEX parsing and serialization are more than 2x faster. (2.9.7) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#297)

### Fixes and other changes

- HWB whiteness and blackness values totaling over 100% are normalized to gray. (2.9.6) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#296)
- Unrounded hue rotation preserves the original color in rotate and harmonies. (2.9.6) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#296)
- Uses adjusted chroma for the CIEDE2000 rotation term, changing delta() values for a small set of colors. (2.9.5) — [release notes](https://github.com/omgovich/colord/blob/b10c2f94457c3bc48af9533b555c308768465d51/CHANGELOG.md#295)