NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #1561 most downloaded on npm
Merge Tailwind CSS classes without style conflicts
Last release 7 days ago
13 Sep 2026
Ships on a steady schedule
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
474 releases · first in 2021
One column per quarter.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix arbitrary shadow with inset not recognized by @dcastil in https://github.com/dcastil/tailwind-merge/pull/392
configuration.md by @stephan281094 in https://github.com/dcastil/tailwind-merge/pull/372Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.2.1...v2.2.2
Thanks to @brandonmcconnell, @manavm1990, @langy, a private sponsor and @jamesreaco for sponsoring tailwind-merge! ❤️
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix stroke-color being incorrectly detected as stroke-width by @dcastil in https://github.com/dcastil/tailwind-merge/pull/371
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.2.0...v2.2.1
Thanks to @brandonmcconnell, @manavm1990 and @langy for sponsoring tailwind-merge! ❤️
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add support for Tailwind CSS v3.4 by @dcastil in https://github.com/dcastil/tailwind-merge/pull/360
Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.1.0...v2.2.0
Thanks to @brandonmcconnell, @manavm1990, @ErwinAI and @langy for sponsoring tailwind-merge! ❤️
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add ClassValidator type to package exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/348
ClassValidator type to package exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/348Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v2.0.0...v2.1.0
Thanks to @brandonmcconnell, @manavm1990, @ErwinAI and @langy for sponsoring tailwind-merge! ❤️
Nothing published for this version
Nothing published for this version
Remove deprecated exports by @dcastil in https://github.com/dcastil/tailwind-merge/pull/288
The tailwind-merge v2 release has been sitting here almost finished for 2 months already. But the timing was never quite right, especially thinking about the increased support needed after the release. In the meantime, the product of the company I work at launched in public beta and I married. Thank you for your patience.
This release focuses on making it easier to configure the library for new users. Check out the migration guide and if you have any questions, feel free to create an issue.
background-image and background-position being merged incorrectly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/300
background-position and background-size can look very similar and Tailwind CSS uses the same bg- prefix for both groups. This results in some limitations for tailwind-merge. If you use background position or background size with arbitrary values, please read this section about how to use them.extendTailwindMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/294conflictingClassGroupModifiers in config non-optional by @dcastil in https://github.com/dcastil/tailwind-merge/pull/291module field from package.json by @dcastil in https://github.com/dcastil/tailwind-merge/pull/289extendTailwindMerge by @dcastil in https://github.com/dcastil/tailwind-merge/pull/294conflictingClassGroupModifiers in config non-optional by @dcastil in https://github.com/dcastil/tailwind-merge/pull/291module field from package.json by @dcastil in https://github.com/dcastil/tailwind-merge/pull/289background-image and background-position being merged incorrectly by @dcastil in https://github.com/dcastil/tailwind-merge/pull/300true for empty strings by @dcastil in https://github.com/dcastil/tailwind-merge/pull/295bg-size and bg-position class groups in docs by @dcastil in https://github.com/dcastil/tailwind-merge/pull/328Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.14.0...v2.0.0
Thanks to @quezlatch, @brandonmcconnell, @manavm1990 and @ErwinAI for sponsoring tailwind-merge! ❤️
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Improve support for arbitrary values by @dcastil in https://github.com/dcastil/tailwind-merge/pull/263
mt-[calc(theme(fontSize.4xl)/1.125)] would not be recognized correctly because no length unit is present in the arbitrary value.calc(), min(), max() and clamp() function is used in the arbitrary value.mt-[…] the arbitrary value can only be a length, so I don't check for it. A consequence of this is that if you use non-Tailwind classes like mt-[this-is-totally-not-tailwind], tailwind-merge will recognize it as a Tailwind class from now on. Please don't use classes that look like Tailwind classes with arbitrary value but aren't Tailwind classes with tailwind-merge (in default config) to prevent incorrect merging behavior.col-span-full class missing in default config by @dcastil in https://github.com/dcastil/tailwind-merge/pull/267Full Changelog: https://github.com/dcastil/tailwind-merge/compare/v1.13.2...v1.14.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →