unstale

npm / tailwind-merge

tailwind-merge

What changed in tailwind-merge 2 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-17.

2 new APIs and options1 performance3 behavior and defaults11 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.1.0 on npm

tailwind-merge 316 changes

New APIs and options 2

  • Theme getters now expose the referenced theme key so tooling can identify the theme scale without calling the getter.

    3.7.0release notes

  • Adds a config option for Tailwind utilities where a slash is part of the full class name, such as named container queries.

    3.6.0release notes

Performance 1

  • Performance optimizations make tailwind-merge more than 10% faster.

    3.4.0release notes

Behavior and default changes 3

  • Adds support for readonly array values in the technology's accepted inputs.

    3.6.0release notes

  • Adds support for Tailwind CSS v4.3 utilities, including utilities whose full class name contains a slash.

    3.6.0release notes

  • Adds support for Tailwind CSS v4.2, allowing tailwind-merge to handle its class names and utilities.

    3.5.0release notes

Fixes and other changes 10

  • Bare bg-conic now merges correctly with other background image classes.

    3.7.0release notes

  • Arbitrary values using color() are now classified as colors instead of lengths.

    3.7.0release notes

  • columns-auto now conflicts correctly with other columns classes.

    3.7.0release notes

  • Container sizes such as inline-2xl now merge correctly.

    3.7.0release notes

  • leading-none is no longer removed when the leading theme scale is overridden.

    3.7.0release notes

  • Arbitrary values using light-dark() are now classified as colors instead of lengths.

    3.7.0release notes

  • max-h-none is now included in the max-h class group.

    3.7.0release notes

  • Axis shorthand px now overrides logical sides such as ps correctly.

    3.7.0release notes

  • Deprecated shadow-inner is now classified as a shadow instead of a shadow color.

    3.7.0release notes

  • Prevents arbitrary font-family and font-weight values from merging incorrectly.

    3.4.1release notes

tailwind-merge 21 changes

Fixes and other changes 1

  • Arbitrary values using color-mix are now detected as colors by tailwind-merge.

    2.6.1release notes