Packages

@headlessui/react

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

Upgrading @headlessui/react From 1.7.19 to 2.2.10

27 releases in betweenevery note read

Reading releases, release notes and advisories…

  1. 1.7.19yours
  2. 2.0.0major
  3. 25 releases
  4. 2.2.10target

Before you upgrade

Tick each one off as you go
  • Breaking2.0.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

11 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

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.