NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1327 most downloaded on npm
<img src="https://react-resizable-panels.vercel.app/og.png" alt="react-resizable-panels logo" width="400" height="210" />
Latest stable
4.24.1
Last release 4 days ago
18 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
237 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
651: Disabled the change to collapsible panel behavior that was originally made in 635 due to another reported regression
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
646: Re-enable the collapsible Panel from 4.5.3 that was disabled in 4.5.6
644: Disabled the change to collapsible panel behavior that was originally made in 635.
641: Removed aria-orientation role from root Group element as this was invalid according to the ARIA spec; (for more information see the discussion on
638: Panel avoids unnecessary re-renders in response to mouse-hover state.
Panel avoids unnecessary re-renders in response to mouse-hover state.Panel re-renders in response to mouse-hover state. - #638635: Expand pre-collapsed panels if drug past the halfway point for more consistent collapse/expand behavior.
Nothing published for this version
626: Decrease default hit target size for Separator and Panel edges; make configurable via a new Group prop.
Separator and Panel edges; make configurable via a new Group prop.Separator and Panel edges, and make it configurable via a new Group prop. - #626624: Bugfix: Fallback to alternate CSS cursor styles for Safari
| Safari | Chrome, Firefox |
|---|---|
grab |
move |
col-resize |
ew-resize |
row-resize |
ns-resize |
| Safari | Chrome, Firefox |
|---|---|
grab |
move |
col-resize |
ew-resize |
row-resize |
ns-resize |
616: Replace Separator and Panel edge hit-area padding with a minimum size threshold based on Apple's user interface guidelines. Separators that are l
Separator and Panel edge hit-area padding with a minimum size threshold based on Apple's user interface guidelines. Separators that are large enough will no longer be padded; separators that are too small (or panels without separators) will more or less function like before. This should not have much of a user-facing impact other than an increase in the click target area. (Previously I was not padding enough, as per Apple's guidelines.)Separator resets its associated Panel to its default-size (see video below); double-click will have no impact on panels without default sizesadoptedStyleSheetsDemo of double-clicking on a separator:
https://github.com/user-attachments/assets/f19f6c5e-d290-455e-9bad-20e5038c3508
Separator and Panel edge hit-area padding with a minimum hit target size (per Apple's user interface guidelines), which increases the click target of small separators. - #616Panel to its default size when its associated Separator is double-clicked (see video below). Double-clicking has no effect on panels without default sizes. - #615, #620adoptedStyleSheets being overridden. - #618Demo of double-clicking on a separator:
https://github.com/user-attachments/assets/f19f6c5e-d290-455e-9bad-20e5038c3508
610: Fix calculated cursor style when "pointermove" event is has low-precision/rounded clientX and clientY values
"pointermove" event is has low-precision/rounded clientX and clientY values"pointermove" event has low-precision/rounded clientX and clientY values. - #610600: Bugfix: Collapsible Panel should treat defaultSize={0} as _collapsed_ on mount
Panel should treat defaultSize={0} as collapsed on mountPanel not treating defaultSize={0} as collapsed on mount. - #600…to support the old callback as well, with a @deprecation tag).
onLayoutChanged prop to Group.For layout changes caused by pointer events, this method is not called until the pointer has been released. This callback should be used if you're doing something like saving a layout as it is called less frequently than the previous approach.
The useDefaultLayout hook has also been updated to use this callback (though it will continue to support the old callback as well, with a @deprecation tag).
595: Don't call event.preventDefault() on "pointerup" unless a handle was actively dragged
event.preventDefault() on "pointerup" unless a handle was actively dragged[!NOTE] This change also fixes a text selection bug that impacted Windows users (#574)
event.preventDefault() on "pointerup" unless a handle was actively dragged. - #595[!NOTE] This change also fixes a text selection bug that impacted Windows users (#574)
Moved flex-grow Panel style to an inline value instead of a CSS variable defined on the parent Group to improve rendering performance. (This significa
flex-grow Panel style to an inline value instead of a CSS variable defined on the parent Group to improve rendering performance. (This significantly reduces the negative impact from forced-reflow)Nothing published for this version
588: Replace "unset" styles with safer override values
"unset" styles with safer override values"pointerdown" and "pointerup" events; this is necessary for compatibility with certain UI libraries like Blueprint JSPanel pixel size using offsetWidth/offsetHeight rather than inlineSize to avoid an edgecase bug with ResizeObserver"unset" styles with safer override values. - #588"pointerdown" and "pointerup" events. This is necessary for compatibility with certain UI libraries like Blueprint JS. - #589Panel pixel size using offsetWidth/offsetHeight rather than inlineSize to avoid an edge case bug with ResizeObserver. - #590583: Group component now sets default width, height, and overflow styles; (both can be overridden using the style property)
Group component now sets default width, height, and overflow styles; (both can be overridden using the style property)event.preventDefault for the primary buttonuseGroupRef and usePanelRef to include | null to increase compatibility with older React versionsPanel and Separator componentswidth, height, and overflow styles on Group (these can be overridden using the style prop). - #583event.preventDefault for drag interactions with the primary button. - #582useGroupRef and usePanelRef to include | null to increase compatibility with older React versions. - #583Panel and Separator components. - #583Nothing published for this version
Nothing published for this version
useDefaultLayout hook initializes storage param to localStorage if undefined.
useDefaultLayout hook initializes storage param to localStorage if undefined.Panel prop onResize that impacted certain TypeScript versions.Nothing published for this version
2a6b03f: Add displayName property to Group, Panel, and Separator components for better debugging experience.
Nothing published for this version
573: Add prevPanelSize param to onResize callback to help simplify collapse/expand detection.
prevPanelSize param to onResize callback to help simplify collapse/expand detection.Update TS types to better reflect that Separator attributes role and tabIndex cannot be overridden using props. - #571
Separator attributes role and tabIndex cannot be overridden using props. - #571567: useDefaultLayout hook supports saving and restoring multiple Panel layouts
563: Panel expand() API should restore pre-collapse size
556: Ignore defaultLayout when keys don't match Panel ids
defaultLayout when keys don't match Panel ids555: Allow resizable panels to be rendered into a different Window (e.g. popup or frame) by accessing globals through element.ownerDocument.defaultVie
element.ownerDocument.defaultViewuseDefaultLayout: Deprecated groupId param in favor of id to avoid confusion; (there is no actual requirement for the Group to have a matching id)
useDefaultLayout: Deprecated groupId param in favor of id to avoid confusion; (there is no actual requirement for the Group to have a matching id)useDefaultLayout groupId param in favor of id to avoid confusion (there is no actual requirement for the Group to have a matching id). - #553552: useDefaultLayout now debounces calls to storage.setItem by 150ms
useDefaultLayout now debounces calls to storage.setItem by 150msuseDefaultLayout calls to storage.setItem by 150ms. - #552// To opt out of this change
useDefaultLayout({
debounceSaveMs: 0,
groupId: "test-group-id",
storage: localStorage
});
[!NOTE] Some may consider this a breaking change, considering the default value is 150ms rather than 0ms. I think in practice this should only impact unit tests which can be easily fixed by overriding the default (as shown above) or by using fake timers.
Changes like this are often judgement calls, but I think on balance it's better to correct my initial oversight of not debouncing this by default.
8604491: Fix edge case bug with panel constraints not being properly invalidated after resize
- #551: Expand fixed-size element support
- #542: Clicks on higher z-index elements (e.g. modals) should not trigger separators behind them - #547: Don't re-mount Group when defaultLayout or d
z-index elements (e.g. modals) should not trigger separators behind themdefaultLayout or disableCursor props changePanel id changesz-index elements (e.g. modals) triggering separators behind them. - #542Group when defaultLayout or disableCursor props change. - #547Panel id changes. - #548Group is within a hidden DOM subtree; defer layout-change events. - #549Nothing published for this version
40d4356: Gracefully handle invalid defaultLayout value
Nothing published for this version
Nothing published for this version
Nothing published for this version
f07bf00: Reset pointer-event styles after "pointerup" event
pointer-event styles after "pointerup" event0796644: Account for Flex gap when calculating pointer-move delta %
- #535: Updated docs to make size and layout formats clearer
e08fe42: Improve iOS/Safari resize UX
Fixed TS type for defaultLayout value returned from useDefaultLayout
defaultLayout value returned from useDefaultLayoutdefaultLayout value returned from useDefaultLayout. - cdcce44Export GroupImperativeHandle and PanelImperativeHandle types.
GroupImperativeHandle and PanelImperativeHandle types.GroupImperativeHandle and PanelImperativeHandle types. - 7c56dd4## 4.0.1 - #530: Edge case bug fix: Account for pointer resize events near edge of window/iframe
Version 4 of react-resizable-panels offers more flexible size constraints, supporting units as pixels, percentages, REMs/EMs, and more. Support for server-rendering (including Server Components) has also been expanded.
Version 4 of react-resizable-panels offers more flexible size constraints– supporting units as pixels, percentages, REMs/EMs, and more. Support for se
Version 4 of react-resizable-panels offers more flexible size constraints– supporting units as pixels, percentages, REMs/EMs, and more. Support for server-rendering (including Server Components) has also been expanded.
Refer to the docs for a complete list of props and API methods. Below are some examples of migrating from version 3 to 4, but first a couple of potential questions:
<dl> <dt>Q: Why'd you rename <component> or <prop>?</dt> <dd>A: The most likely reason is that I think the new name more closely aligns with web standards like WAI-ARIA and CSS. For example, the <code>PanelResizeHandle</code> component was renamed to <code>Separator</code> to better align with the <a href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/separator_role">ARIA "separator" role</a> and the <code>direction</code> prop was renamed to <code>orientation</code> to better align with the <a href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-orientation">ARIA <code>orientation</code> attribute </a>.</dd> <dt>Q: Why'd you remove support for <feature>?</dt> <dd>A: Probably because it wasn't used widely enough to justify the complexity required to maintain it. If it turns out that I'm mistaken, features can always be (re)added but it's more difficult to remove them.</dd> <dt>Q: Were the <code>onCollapse</code> and <code>onExpand</code> event handlers removed?</dt> <dd>A: Yes. Use the <code>onResize</code> event handler instead:
onResize={(size) => {
// Either this
const isCollapsed = size === collapsedSize;
// Or this:
panelRef.isCollapsed();
}}
</dd> </dl>
// Version 3
import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";
<PanelGroup direction="horizontal">
<Panel defaultSize={30} minSize={20}>left</Panel>
<PanelResizeHandle />
<Panel defaultSize={30} minSize={20}>right</Panel>
</PanelGroup>
// Version 4
import { Group, Panel, Separator } from "react-resizable-panels";
<Group orientation="horizontal">
<Panel defaultSize={30} minSize={20}>left</Panel>
<Separator />
<Panel defaultSize={30} minSize={20}>right</Panel>
</Group>
// Version 3
import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";
<PanelGroup autoSaveId="unique-group-id" direction="horizontal">
<Panel>left</Panel>
<PanelResizeHandle />
<Panel>right</Panel>
</PanelGroup>
// Version 4
import { Group, Panel, Separator, useDefaultLayout } from "react-resizable-panels";
const { defaultLayout, onLayoutChange } = useDefaultLayout({
groupId: "unique-group-id",
storage: localStorage
});
<Group defaultLayout={defaultLayout} onLayoutChange={onLayoutChange}>
<Panel>left</Panel>
<Separator />
<Panel>right</Panel>
</Group>
[!NOTE] Refer to the docs for examples of persistent layouts with server rendering and server components.
// Version 3
import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";
<PanelGroup autoSaveId="unique-group-id" direction="horizontal">
{showLeftPanel && (
<>
<Panel id="left" order={1}>left</Panel>
<PanelResizeHandle />
</>
)}
<Panel id="center" order={2}>center</Panel>
{showRightPanel && (
<>
<PanelResizeHandle />
<Panel id="right" order={3}>right</Panel>
</>
)}
</PanelGroup>
// Version 4
import { Group, Panel, Separator } from "react-resizable-panels";
<Group>
{showLeftPanel && (
<>
<Panel id="left">left</Panel>
<Separator />
</>
)}
<Panel id="center">center</Panel>
{showRightPanel && (
<>
<Separator />
<Panel id="right">right</Panel>
</>
)}
</Group>
// Version 3
import { PanelGroup, Panel, PanelResizeHandle } from "react-resizable-panels";
import type { ImperativePanelGroupHandle, ImperativePanelHandle }from "react-resizable-panels";
const panelRef = useRef<ImperativePanelHandle>(null);
const panelGroupRef = useRef<ImperativePanelGroupHandle>(null);
<PanelGroup direction="horizontal" ref={panelGroupRef}>
<Panel ref={panelRef}>left</Panel>
<PanelResizeHandle />
<Panel>right</Panel>
</PanelGroup>
// Version 4
import { Group, Panel, Separator, useGroupRef, usePanelRef } from "react-resizable-panels";
const groupRef = useGroupRef();
const panelRef = usePanelRef();
<Group groupRef={groupRef} orientation="horizontal">
<Panel panelRef={panelRef}>left</Panel>
<Separator />
<Panel>right</Panel>
</Group>
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
- #517: Fixed Firefox bug that caused resizing to be interrupted unexpected
Nothing published for this version
- #512: Fixed size precision regression from 2.0.17
- #503: Support custom cursors
One column per quarter.