# tailwind-merge: what changed from 2 to 3

- Product: tailwind-merge (https://whatsnew.fyi/product/tailwind-merge)
- Vendor: Dany Castillo
- Range: changelog entries numbered after v2.6.1 up to and including v3.6.0, stable releases only
- Entries below: 9 releases (newest first)
- Resolved: 2 is v2.6.1 and 3 is v3.6.0, the newest stable release of each major we track
- Carrying security changes: 1 · CVEs mentioned: 0 · Mentioning breaking changes: 0 · Removing or deprecating something: 0
- Page: https://whatsnew.fyi/product/tailwind-merge/compare/2...3

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## What changed (15 changes, grouped by kind)

### Added

#### v3.6.0 (2026-05-10)

- Add support for Tailwind CSS v4.3
- Add postfixLookupClassGroups option to config to support Tailwind utilities where a slash is part of the full class name, like named container queries
- Add support for readonly array values

#### v3.5.0 (2026-02-18)

- Add support for Tailwind CSS v4.2

#### v3.3.0 (2025-05-11)

- Add support for Tailwind CSS v4.1.5

#### v3.2.0 (2025-04-06)

- Add support for Tailwind CSS v4.1

#### v3.1.0 (2025-03-31)

- Add support for Tailwind CSS v4.0.10

### Changed

#### v3.4.0 (2025-11-09)

- Make tailwind-merge over 10% faster with performance optimizations

### Fixed

#### v3.6.0 (2026-05-10)

- Fix broken links in README

#### v3.4.1 (2026-02-15)

- Prevent arbitrary font-family and font-weight from merging

#### v3.3.1 (2025-06-10)

- Fix arbitrary value using color-mix() not being detected as color

#### v3.1.0 (2025-03-31)

- Fix length variable in via-(length:*) class being merged with via-<color> classes accidentally

#### v3.0.2 (2025-02-22)

- Fix px value not being recognized for some class groups
- Fix doc comment being in incorrect place in default config

### Security

#### v3.6.0 (2026-05-10)

- Harden internal CI pipeline security by omitting git checkout

## Release notes

### v3.6.0

- Date: 2026-05-10
- Version: v3.6.0
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.6.0
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.6.0

- **added** — Add support for Tailwind CSS v4.3
- **added** — Add postfixLookupClassGroups option to config to support Tailwind utilities where a slash is part of the full class name, like named container queries
- **added** — Add support for readonly array values
- **fixed** — Fix broken links in README
- **security** — Harden internal CI pipeline security by omitting git checkout

###### New Features

- Add support for Tailwind CSS v4.3 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/677
  - Add `postfixLookupClassGroups` option to config to support Tailwind utilities where a slash is part of the full class name, like named container queries
- Add support for readonly array values by @unional in https://github.com/dcastil/tailwind-merge/pull/652

###### Documentation

- Fix broken links in README by @maurer2 in https://github.com/dcastil/tailwind-merge/pull/662

###### Other

- Harden internal CI pipeline security by omitting git checkout by @dcastil, suggested by @kyletaylored in https://github.com/dcastil/tailwind-merge/commit/6b2499c10cf52bed42426d30b4219e90374b30d6

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.5.0...v3.6.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw, @sourcegraph, @mike-healy and more via @thnxdev for sponsoring tailwind-merge! ❤️

### v3.5.0

- Date: 2026-02-18
- Version: v3.5.0
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.5.0
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.5.0

- **added** — Add support for Tailwind CSS v4.2

###### New Features

- Add support for Tailwind CSS v4.2 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/651

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.4.1...v3.5.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw, @sourcegraph and more via @thnxdev for sponsoring tailwind-merge! ❤️

### v3.4.1

- Date: 2026-02-15
- Version: v3.4.1
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.4.1
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.4.1

- **fixed** — Prevent arbitrary font-family and font-weight from merging

###### Bug Fixes

- Prevent arbitrary font-family and font-weight from merging by @roneymoon in https://github.com/dcastil/tailwind-merge/pull/635

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.4.0...v3.4.1

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, a private sponsor, @block, @openclaw, @sourcegraph and more via @thnxdev for sponsoring tailwind-merge! ❤️

### v3.4.0

- Date: 2025-11-09
- Version: v3.4.0
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.4.0
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.4.0

- **changed** — Make tailwind-merge over 10% faster with performance optimizations

###### New Features

- Performance optimizations which make tailwind-merge >10% faster
    - Vibe optimization by @quantizor in https://github.com/dcastil/tailwind-merge/pull/547
    - Additional optimizations by @quantizor in https://github.com/dcastil/tailwind-merge/pull/619

###### Documentation

- Improve docs by clarifying things, adding more examples by @dcastil in https://github.com/dcastil/tailwind-merge/pull/618
- Make examples more realistic by @dcastil in https://github.com/dcastil/tailwind-merge/pull/617
- Add custom variant as an alternative to docs by @kidonng in https://github.com/dcastil/tailwind-merge/pull/592

###### Other

- Improve benchmarking suite by @quantizor in https://github.com/dcastil/tailwind-merge/pull/620

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.3.1...v3.4.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov and a private sponsor for sponsoring tailwind-merge! ❤️

### v3.3.1

- Date: 2025-06-10
- Version: v3.3.1
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.3.1
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.3.1

- **fixed** — Fix arbitrary value using color-mix() not being detected as color

###### Bug Fixes

- Fix arbitrary value using `color-mix()` not being detected as color by @dcastil in https://github.com/dcastil/tailwind-merge/pull/591

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.3.0...v3.3.1

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph, a private sponsor, @block and @shawt3000 for sponsoring tailwind-merge! ❤️

### v3.3.0

- Date: 2025-05-11
- Version: v3.3.0
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.3.0
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.3.0

- **added** — Add support for Tailwind CSS v4.1.5

###### New Features

- Add support for tailwind CSS v4.1.5 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/575

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.2.0...v3.3.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph, a private sponsor and @block for sponsoring tailwind-merge! ❤️

### v3.2.0

- Date: 2025-04-06
- Version: v3.2.0
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.2.0
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.2.0

- **added** — Add support for Tailwind CSS v4.1

###### New Features

- Add support for Tailwind CSS v4.1 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/565

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.1.0...v3.2.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️

### v3.1.0

- Date: 2025-03-31
- Version: v3.1.0
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.1.0
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.1.0

- **added** — Add support for Tailwind CSS v4.0.10
- **fixed** — Fix length variable in via-(length:*) class being merged with via-<color> classes accidentally

###### New Features

- Add support for Tailwind CSS v4.0.10 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/546

###### Bug Fixes

- Fix length variable in `via-(length:*)` class being merged with `via-<color>` classes accidentally by @dcastil in https://github.com/dcastil/tailwind-merge/pull/559

###### Documentation

- Fix typo in comment in types.ts by @roottool in https://github.com/dcastil/tailwind-merge/pull/549
- Update shadow scale recipe to tailwind merge v3 API by @dcastil in https://github.com/dcastil/tailwind-merge/pull/545

###### Other

- Fix metrics report action erroring on PRs from forks by @dcastil in https://github.com/dcastil/tailwind-merge/pull/551

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.0.2...v3.1.0

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️

### v3.0.2

- Date: 2025-02-22
- Version: v3.0.2
- Original notes: https://github.com/dcastil/tailwind-merge/releases/tag/v3.0.2
- Permalink: https://whatsnew.fyi/product/tailwind-merge/releases/v3.0.2

- **fixed** — Fix px value not being recognized for some class groups
- **fixed** — Fix doc comment being in incorrect place in default config

###### Bug Fixes

- Fix `px` value not being recognized for some class groups by @dcastil in https://github.com/dcastil/tailwind-merge/pull/538
- Fix doc comment being in incorrect place in default config by @gjtorikian in https://github.com/dcastil/tailwind-merge/pull/526

**Full Changelog**: https://github.com/dcastil/tailwind-merge/compare/v3.0.1...v3.0.2

Thanks to @brandonmcconnell, @manavm1990, @langy, @jamesreaco, @roboflow, @syntaxfm, @getsentry, @codecov, @sourcegraph and a private sponsor for sponsoring tailwind-merge! ❤️