Skip to content
npm

@headlessui/react

A set of completely unstyled, fully accessible UI components for React, designed to integrate beautifully with Tailwind CSS.

About
a11yaccessibilitycomponentsheadless-uiheadlessuireacttailwindcssvue
@headlessuigithub.com/tailwindlabs/headlessuigithub.com/tailwindlabs/headlessui#readmeMITreinink, adamwathan, malfaitrobin9.8M / week28.8k · 1.2k forks · 75 contributors
Compare
Compares against 2.2.10 (latest stable)
Latest Stable2.2.10Apr 7, 2026
Latest Alpha2.0.0-alpha.4Jan 3, 2024
Release cadenceEvery 2 weeks
Last releaseApr 13, 2026
Open advisories0
Changelog quality16% curated
GitHub Releases, gaps for some releases
Release history SecurityYou're on
1.x2.x
STABLE · RCPRE-RELEASEJulOct2024AprJulOct2025AprJulOct2026Apr

429 older or filtered releases not shown.

Upgrade guides

Breaking changes and a migration checklist for each major version
@headlessui/react 1 → 21.7.19 → 2.2.10Apr 7, 2026 BreakingBreaking5Deprecated11New39Changed15Fixed108@headlessui/react 0.3 → 10.3.2 → 1.7.19Apr 15, 2024 BreakingBreaking2Platform2New31Changed3Fixed211Other8@headlessui/react 0.2 → 0.30.2.0 → 0.3.2Apr 2, 2021 BreakingBreaking3New4Fixed12@headlessui/react 0.1 → 0.20.1.3 → 0.2.0Oct 6, 2020 UnknownNew2
VersionChannelDateChangesSecurity
2.2.10 StableApr 7, 2026Fixed22.2.9 StableSep 25, 2025Fixed92.2.8 StableSep 12, 2025Fixed112.2.7 StableJul 30, 2025Fixed42.2.6 StableJul 24, 2025Fixed12.2.5 StableJul 23, 2025Fixed12.2.4 StableMay 20, 2025Fixed12.2.3 StableMay 12, 2025New1Changed1Fixed52.2.2 StableApr 17, 2025Fixed52.2.1 StableApr 4, 2025New2Changed1Fixed42.2.0 StableOct 25, 2024Changed12.1.10 youStableOct 10, 2024Fixed22.1.9 StableOct 3, 2024Fixed32.1.8 StableSep 12, 2024Fixed12.1.7 StableSep 11, 2024Fixed12.1.6 StableSep 9, 2024Fixed22.1.5 StableSep 4, 2024Fixed12.1.4 StableSep 3, 2024Fixed12.1.3 StableAug 23, 2024Fixed32.1.2 StableJul 5, 2024Fixed8