NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #3486 most downloaded on npm
Latest stable
1.8.1
Last release 1 months ago
14 Oct 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 27 of 30 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
202 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Fixed a type regression where callback props that were previously declared as methods rejected handlers whose parameter is narrower than the prop's.
@radix-ui/react-accordion@1.3.1, @radix-ui/react-avatar@1.3.1, @radix-ui/react-checkbox@1.4.1, @radix-ui/react-collapsible@1.2.1, @radix-ui/react-context-menu@2.4.1, @radix-ui/react-dialog@1.3.1, @radix-ui/react-dismissable-layer@1.2.1, @radix-ui/react-dropdown-menu@2.2.1, @radix-ui/react-focus-scope@1.3.1, @radix-ui/react-hover-card@1.2.1, @radix-ui/react-menu@2.2.1, @radix-ui/react-menubar@1.2.1, @radix-ui/react-navigation-menu@1.4.1, @radix-ui/react-one-time-password-field@0.2.1, @radix-ui/react-password-toggle-field@0.2.1, @radix-ui/react-popover@1.3.1, @radix-ui/react-progress@1.2.1, @radix-ui/react-roving-focus@1.2.1, @radix-ui/react-select@2.4.1, @radix-ui/react-slider@1.6.1, @radix-ui/react-switch@1.4.1, @radix-ui/react-tabs@1.2.1, @radix-ui/react-toast@1.3.1, @radix-ui/react-toggle@1.2.1, @radix-ui/react-toggle-group@1.2.1, @radix-ui/react-tooltip@1.4.1, @radix-ui/react-alert-dialog@1.2.1, @radix-ui/react-radio-group@1.5.1, @radix-ui/react-toolbar@1.2.1Your coding agent can read these notes before it upgrades. Set up the MCP server →
Some small and breaking changes in unstable collection APIs. This package is an internal utility, undocumented, and unstable APIs may change without a…
side, sideOffset, and align props to be overridden on ContextMenu.Content.data-state attribute to the content element when using NavigationMenu.Viewport for consistency.aria-controls being set on Popover.Trigger while the popover is closed.Select value programmatically while inside a <form> would dispatch a click event from the hidden bubble select that propagated to ancestor onClick handlers.Slider value programmatically while inside a <form> would dispatch an input event that propagated to ancestor onInput handlers.Slot throwing when an asChild child is a lazy reference whose resolved value is itself a lazy reference.Toast.Viewport forcing a still-hydrating Suspense boundary to client-render.undefined for all optional types for compatibility with TypeScript's exactOptionalPropertyTypes flag.useCallbackRef.FocusScope throwing a TypeError in test environments after teardown.unstable_CollectionProps to unstable_CollectionSlotProps and unstable_CollectionItemMap to unstable_CollectionDict.useGetCollection to the functions returned from unstable_createCollection.unstable_createCollection.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
Fixed nested, portalled layers being unusable inside a modal layer. A non-modal popover rendered inside a modal Dialog previously broke some user inte
FocusScope reclaimed focus, and its RemoveScroll only allowed scrolling within the modal content.disableToggle prop to NavigationMenu.Sub.
true: Clicking the trigger of an already-open submenu item keeps it open. This is the default and matches existing behavior.false: Clicking the trigger of a submenu item toggles it open or closed.activationMode prop to NavigationMenu.Root and NavigationMenu.Sub.
"automatic": Hovering or focusing a trigger opens its item, and moving away from the trigger closes it after a short delay. This is the default and matches existing behavior."manual": Pointer entry and focus never open an item. The item opens when its trigger is clicked.activationMode is omitted on NavigationMenu.Sub, it inherits the value from the parent NavigationMenu.Root, so setting "manual" on the root also applies to submenus unless a submenu opts back in to "automatic".defaultValue was reset when an external element was focused before the menu opened.NavigationMenu.Viewport discarded its children and rendered the active content in their place. The active content is now rendered inside the consumer's element alongside any children it already had.Popover.Title and Popover.Description parts that provide accessible names and descriptions for popover content.Added a ScrollArea.Content part so consumers can own the wrapper element implicitly rendered by ScrollArea.Viewport. Pass disableImplicitContentElement to the viewport and render ScrollArea.Content as its child.
<ScrollArea.Root>
<ScrollArea.Viewport disableImplicitContentElement>
<ScrollArea.Content>{children}</ScrollArea.Content>
</ScrollArea.Viewport>
<ScrollArea.Scrollbar>
<ScrollArea.Thumb />
</ScrollArea.Scrollbar>
</ScrollArea.Root>
In the next major release, the viewport will no longer render this element implicitly. We recommend migrating to this API now for a smoother upgrade.
Fixed a bug where asChild on ScrollArea.Viewport merged props onto the implicit content element instead of the consumer's element.
preserveThumbOrder prop to Slider that prevents thumbs from crossing over one another. When enabled, each thumb is constrained to the values of its neighbors instead of swapping positions when dragged past them.aria-describedby attributes, so id strings from a component and its child are merged, normalized, and deduplicated instead of one replacing the other.Select.Item elements.Toast would not auto-close after its duration changed while the timer was paused.Tabs.Content did not fire a blur event before the tab switched. Tabs.Trigger now moves focus before the tab's state change.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
Reverted breaking changes that caused compatibility issues with React Server Components.
Republish through CI to attach provenance attestations. The previous versions of these packages were published manually outside of CI and therefore sh
Fixed a regression where importing primitives from the root radix-ui entry point erased every primitive's types to any.
radix-ui entry point erased every primitive's types to any.Fixed broken ARIA references in Dialogs where title or description elements are not rendered.
onValueCommit was not called when a slider thumb was dragged across another thumb.Toast removing non-focused toasts when pressing Escape.Tooltip.Content children were mounted to the DOM twice.Popper.Content./* @__PURE__ */ and use named render functions instead of Component.displayName = ... assignments, which previously prevented dead-code elimination with some bundlers.virtualRef prop type to allow RefObject<Measurable | null> in popover components.import { Accordion } from 'radix-ui/accordion' or import * as Accordion from 'radix-ui/accordion'. This mirrors the namespaced exports available from the root radix-ui entry point.Checkbox, Switch, or RadioGroup value programmatically (eg. a "select all" control) while inside a <form> would dispatch a click event from the hidden bubble input that propagated to ancestor onClick handlers.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
Added CSS custom properties for Navigation Menu item indicators' translate values.
Form.Message, Form.Control, Form.Label and Form.ValidityState that are correctly rendered outside of Form.Field componentsRadioGroup, Slider, Select, and Switch.Space/Enter keys that originate from focusable descendants.onEscapeKeyDown/onDismiss handlers on React 19.2.useEffectEvent.--radix-scroll-area-corner-width and --radix-scroll-area-corner-height not resetting to 0 when a corner is removed. Previously these values would stick around and leave a permanent gap on the remaining scrollbar.<input type="range"> behavior.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Cleared the close timer when unmounting Toast components to prevent memory leaks and errors in test environments.
Toast components to prevent memory leaks and errors in test environments.React.CSSProperties augmentation from emitted declaration files.Nothing published for this version
`tsx const Slot = createSlot ('Slot'); `
const Slot = createSlot<HTMLButtonElement, MyCustomButtonProps>('Slot');
Avatar.Image components per Avatar.Root was never supported and results in buggy, unpredictable behavior. We now warn about this in development.loading, meaning that onLoadingStatusChange is never called once loaded. A zero-sized image now triggers an error status on load.onVisiblityChange prop to onVisibilityChange.asChild for all component parts.SlotProps and createSlot now accept generic type arguments to specify the type of element a slot should render, as well as its props.radiogroup and toolbar roles, respectively.Select.Item with an empty string value to act as a "clear" option. Selecting it resets the selection back to the placeholder, restoring the native <select> behavior for optional selects. Previously using an empty string value would throw an error.Duplicate index signature errors that surfaced when consuming multiple packages together.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
Added support for a controlled open prop on ContextMenu.Root. This is intended for reading the open state and closing the menu programmatically, thoug
Added support for a controlled open prop on ContextMenu.Root. This is intended for reading the open state and closing the menu programmatically, though we discourage opening the menu programmatically since opening the menu depends on user interaction to position the menu.
function ControlledContextMenu() {
const [open, setOpen] = React.useState(false);
return (
<ContextMenu.Root open={open} onOpenChange={setOpen}>
<ContextMenu.Trigger>Open</ContextMenu.Trigger>
<ContextMenu.Content>
<button type="button" onClick={() => setOpen(false)}>
Close me
</button>
<ContextMenu.Item>Item 1</ContextMenu.Item>
<ContextMenu.Item>Item 2</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Root>
);
}
Fixed a bug in where submenus remained expanded after re-opening on long-press touch events.
"Text" clipboard format by reading the pasted value as "text/plain".data-side and data-align on PopperAnchor elementPresence was given a child with an unstable ref.Added unstable RadioGroupItemProvider, RadioGroupItemTrigger and RadioGroupItemBubbleInput parts. These expose the previously internal composition of a radio item that included a visually hidden input so consumers can directly access and recompose them. The RadioGroupItem component continues to render them by default.
import { RadioGroup } from 'radix-ui';
function ExampleRadioGroup() {
return (
<RadioGroup.Root>
{['one', 'two', 'three'].map((value) => (
<RadioGroup.unstable_ItemProvider key={value} value={value}>
<RadioGroup.unstable_ItemTrigger>
<RadioGroup.Indicator />
</RadioGroup.unstable_ItemTrigger>
{/* the hidden input is now exposed and can be omitted if not needed */}
<RadioGroup.unstable_ItemBubbleInput />
</RadioGroup.unstable_ItemProvider>
))}
</RadioGroup.Root>
);
}
Added unstable Provider and BubbleInput parts to Select. These expose the previously internal composition that included a visually hidden select so consumers can directly access and recompose them. Select continues to render them by default.
import { Select } from 'radix-ui';
function ExampleSelect() {
return (
<Select.unstable_Provider>
<Select.Trigger />
<Select.Portal />
{/* the hidden input is now exposed and can be omitted if not needed */}
<Select.unstable_BubbleInput />
</Select.unstable_Provider>
);
}
Added support for presence-based exit animations.
Fixed the bubble hidden input so that submits an empty string when no value is selected.
Fixed select closing unexpectedly after touch-scrolling its content when rendered inside an open shadow DOM.
Fixed SelectValue logging invalid prop errors when used with both asChild and a placeholder
Added unstable ThumbProvider, ThumbTrigger, and BubbleInput parts to Slider. SliderThumb was previously a single component that implicitly rendered a hidden native input for form submission. It is now composed from these new parts, which are exposed so consumers can decouple the visually hidden input from the thumb. SliderThumb continues to render them by default.
import { Slider } from 'radix-ui';
function ExampleSlider() {
return (
<Slider.Root defaultValue={[data.price.min, data.price.max]}>
<Slider.Track>
<Slider.Range />
</Slider.Track>
<Slider.unstable_ThumbProvider name="price[min]">
<Slider.unstable_ThumbTrigger />
{/* the hidden input is now exposed and can be omitted if not needed */}
<Slider.unstable_BubbleInput />
</Slider.unstable_ThumbProvider>
<Slider.unstable_ThumbProvider name="price[max]">
<Slider.unstable_ThumbTrigger />
<Slider.unstable_BubbleInput />
</Slider.unstable_ThumbProvider>
</Slider.Root>
);
}
Added focusVisible for non-keyboard interactions with slider thumbs for progressively enabling styles using :focus-visible alongside programmatic focus management.
Fixed a Slider bug where very small step values made the thumbs unresponsive.
Fixed focus bugs for sliders in a scrollable context.
Slottable items via a render prop. This allows a slotted element to be wrapped while still merging Slot props and refs onto it.Slot creating a new ref callback on every render.Added unstable Provider, Trigger and BubbleInput parts to Switch. These expose the previously internal composition that included a visually hidden input so consumers can directly access and recompose them. The Switch component continues to render them by default.
import { Switch } from 'radix-ui';
function ExampleSwitch() {
return (
<Switch.unstable_Provider>
<Switch.unstable_Trigger>
<Switch.Thumb />
</Switch.unstable_Trigger>
{/* the hidden input is now exposed and can be omitted if not needed */}
<Switch.unstable_BubbleInput />
</Switch.unstable_Provider>
);
}
skipDelayDuration={0} works as expected. Previously, the open delay could still be skipped when moving between triggers.useSyncExternalStore (React 18+) instead of importing the CJS-only use-sync-external-store/shim, with a fallback for React < 18. The shim called require("react") at module-evaluation time, which crashed ESM-only browser bundles when importing some components from the radix-ui package.aria-controls when their content is removed from the DOM (credit to @dodomorandi for the original PR).use client directives to modules causing errors in RSC modules.align prop to Menu.SubContent.data-state attribute for Scroll Area scrollbars.Toast.Announce.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
One column per quarter.