Packages

@headlessui/react

2.2.10 · 7 Apr 2026MIT10.3M / weekRepositoryHomepagenpmAtom feed

Upgrading @headlessui/react From 0.1.0 to 2.2.10

71 releases in betweennotes for 65

Reading releases, release notes and advisories…

Other targets from 0.1.0Newest 0.x0.3.2
  1. 0.1.0yours
  2. 3 releases
  3. 0.2.0major
  4. 0.3.0major
  5. 2 releases
  6. 1.0.0major
  7. 9 releases
  8. 1.6.0breaking
  9. 7 releases
  10. 1.7.1breaking
  11. 18 releases
  12. 2.0.0major
  13. 25 releases
  14. 2.2.10target
7+
changes to make
0
advisories fixed
61+
new
309+
fixes

Counted from 65 of 71 release notes. Advisories are counted from the advisory database, in full.

Before you upgrade

Tick each one off as you go
  • Breaking2.0.0
  • Breaking1.7.1
  • Breaking1.6.0
  • Deprecated2.0.4
  • Deprecated2.0.0
  • Deprecated2.0.0
  • Deprecated2.0.0

Release by release

  1. 2.2.10

    7 Apr 20262 fixes
    • Fixed

      Don’t render <Portal> while hydrating

    • Fixed

      Fix passing props on Fragment error due to Symbol(react.lazy)

  2. 2.2.9

    25 Sep 20259 fixes
    • Fixed

      Improve focus management in shadow DOM roots

    • Fixed

      Don't accidentally open the Combobox when touching the ComboboxButton while dragging on mobile

    • Fixed

      Ensure sibling Dialog components are scrollable on mobile

    • Fixed

      Infer Combobox type based on onChange handler

  3. 2.2.8

    12 Sep 202511 fixes
    • Fixed

      Ensure we are not freezing data when the static prop is used

    • Fixed

      Ensure onChange types are contravariant instead of bivariant

    • Fixed

      Support <summary> as a focusable element inside <details>

    • Fixed

      Fix Maximum update depth exceeded crash when using transition prop

  4. 2.2.7

    30 Jul 20254 fixes
    • Fixed

      Fix incorrect double invocation of menu items, listbox options and combobox options

    • Fixed

      Fix memory leak in SSR environment

    • Fixed

      Ensure programmatic .click() on MenuButton ref works

    • Fixed

      Don't activate hovered items while using the keyboard

  5. 2.2.6

    24 Jul 20251 fix
    • Fixed

      Fix immediately closing Listbox by requiring some cursor movement

  6. 2.2.5

    23 Jul 20251 fix
    • Fixed

      Fix listbox closing immediately after opening on touch devices

  7. 2.2.4

    20 May 20251 fix
    • Fixed

      Fix Combobox error (unexpected undefined) when using virtual mode

  8. 2.2.3

    12 May 20251 new · 6 fixes
    • New

      Add a quick trigger action to the Menu, Listbox and Combobox components

    • Fixed

      Fix clicking Label component should open <Input type="file">

    • Fixed

      Ensure clicking on interactive elements inside Label component works

    • Fixed

      Fix focus not returned to SVG Element

    • Fixed

      Fix Listbox not focusing first or last option on ArrowUp / ArrowDown

    • Fixed

      Performance improvement: only re-render top-level component when nesting components e.g.: Menu inside a Dialog

    • Fixed

      Fix closing Menu when other Menu is opened

13 other lines we could not sort, mostly version bumps
  • Use native fieldset instead of div by default for Fieldset component

    2.0.4
  • Built-in anchor positioning — using Floating UI, components like Menu, Listbox, and more can now automatically position their popovers to be anchored to their trigger, adapting as needed to changes in the viewport.

    2.0.0
  • Headless checkbox component — we've added a headless Checkbox component to complement our existing RadioGroup component, making it easy to build totally custom checkbox controls.

    2.0.0
  • HTML form components — we've added Input, Select, Textarea, Label, Description, Fieldset, and Legend components that handle all of the ID generation and aria-* attribute mapping you need to do to connect form fields together.

    2.0.0
  • Improved hover and focus-visible detection — using hooks from the awesome React Aria library under the hood, Headless UI now adds smarter data-hover and data-focus attributes to your controls that behave more consistently across different devices than the native pseudo-classes.

    2.0.0
  • Combobox list virtualization — the Combobox component can now handle giant lists of options with no performance issues.

    2.0.0
  • Always render hidden form input fields for Checkbox, Switch and RadioGroup components

    2.0.0
  • Dialog is now focused by default instead of the first focusable element

    2.0.0
  • Change default tags for ListboxOptions, ListboxOption, ComboboxOptions, ComboboxOption, and TabGroup components

    2.0.0
  • Change default tag from div to Fragment on Transition components (#3110, #3147)

    2.0.0

4 internal lines (docs, tests, tooling) left out.

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.