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.
- #207: Fix DEV conditional error that broke data attributes (and selectors).
Support a mix of percentage and pixel based units at the Panel level:
Support a mix of percentage and pixel based units at the Panel level:
<Panel defaultSizePixels={100} minSizePercentage={20} maxSizePercentage={50} />
Note: Pixel units require the use of a
ResizeObserverto validate. Percentage based units are recommended when possible.
<table> <thead> <tr> <th>v55</th> <th>v56</th> </tr> </thead> <tbody> <tr> <td> <pre lang="jsx"> <Panel defaultSize={25} minSize={10} maxSize={50} /> </pre> </td> <td> <pre lang="jsx"> <Panel defaultSizePercentage={25} minSizePercentage={10} maxSizePercentage={50} /> </pre> </td> </tr> </tbody> </table>
<table> <thead> <tr> <th>v55</th> <th>v56</th> </tr> </thead> <tbody> <tr> <td> <pre lang="jsx"> <PanelGroup direction="horizontal" units="pixels" > <Panel minSize={100} maxSize={200} /> <PanelResizeHandle /> <Panel /> </PanelGroup> </pre> </td> <td> <pre lang="jsx"> <PanelGroup direction="horizontal"> <Panel minSizePixels={100} maxSizePixels={200} /> <PanelResizeHandle /> <Panel /> </PanelGroup> </pre> </td> </tr> </tbody> </table>
For a complete list of supported properties and example usage, refer to the docs.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
New units prop added to PanelGroup to support pixel-based panel size constraints.
units prop added to PanelGroup to support pixel-based panel size constraints.This prop defaults to "percentage" but can be set to "pixels" for static, pixel based layout constraints.
This can be used to add enable pixel-based min/max and default size values, e.g.:
<PanelGroup direction="horizontal" units="pixels">
{/* Will be constrained to 100-200 pixels (assuming group is large enough to permit this) */}
<Panel minSize={100} maxSize={200} />
<PanelResizeHandle />
<Panel />
<PanelResizeHandle />
<Panel />
</PanelGroup>
Imperative API methods are also able to work with either pixels or percentages now. They default to whatever units the group has been configured to use, but can be overridden with an additional, optional parameter, e.g.
panelRef.resize(100, "pixels");
panelGroupRef.setLayout([25, 50, 25], "percentages");
// Works for getters too, e.g.
const percentage = panelRef.getSize("percentages");
const pixels = panelRef.getSize("pixels");
const layout = panelGroupRef.getLayout("pixels");
172: Development warning added to PanelGroup for conditionally-rendered Panel(s) that don't have id and order props
Fix edge case race condition for onResize callbacks during initial mount
onResize callbacks during initial mount162: Add Panel.collapsedSize property to allow panels to be collapsed to custom, non-0 sizes
154: onResize and onCollapse props are called in response to PanelGroup.setLayout
Improved panel size validation in PanelGroup.
PanelGroup.Improved development warnings and props validation checks in PanelGroup.
PanelGroup.PanelGroup. - 3780fd3148: Build release bundle with Preconstruct
Mimic VS Code behavior; collapse a panel if it's smaller than half of its min-size
Improved SSR support: Avoid accessing default storage (localStorage) during initialization; avoid throwing error in browsers that have 3rd party cooki
localStorage) during server rendering initialization, and avoid throwing an error in browsers that have 3rd party cookies/storage disabled. - 5c5a4beSSR: Avoid layout shift by using defaultSize to set initial flex-grow style
defaultSize to set initial flex-grow stylePanel is server-rendered without a defaultSize prop* #142: Avoid re-registering Panel when props change. (Hopefully this will avoid cases where Panels without "order" props subtly break.)
Panel when props change. This should reduce the number of scenarios requiring the order prop. - #142Add imperative getLayout API to PanelGroup
getLayout API to PanelGrouplocalStorage updates to multiple saved groups would drop some valuesChange cursor style from col-resize/row-resize to ew-resize/ns-resize to better match cursor style at edges of a panel.
col-resize/row-resize to ew-resize/ns-resize to better match cursor style at edges of a panel.Add imperative setLayout API for PanelGroup.
setLayout API for PanelGroup.- Update README docs.
* #118: Fix import regression from 0.0.38.
* #117: Panel collapse behavior works better near viewport edges. * #115: PanelResizeHandle logic calls event.preventDefault for events it handles. *
Panel collapse behavior works better near viewport edges.PanelResizeHandle logic calls event.preventDefault for events it handles.useId import changed to avoid triggering errors with older versions of React. (Note this may have an impact on tree-shaking though it is presumed to be minimal, given the small "react" package size.)* #94: Add onDragging prop to PanelResizeHandle to be notified of when dragging starts/stops.
onDragging prop to PanelResizeHandle to be notified of when dragging starts/stops.* #96: No longer disable pointer-events during resize by default. This behavior can be re-enabled using the newly added PanelGroup prop disablePointer
pointer-events during resize by default. This behavior can be re-enabled using the newly added PanelGroup prop disablePointerEventsDuringResize.pointer-events during resize by default. This behavior can be re-enabled using the newly added PanelGroup prop disablePointerEventsDuringResize. - #96* #92: Change browserslist so compiled module works with CRA 4.0.3 Babel config out of the box.
browserslist so compiled module works with CRA 4.0.3 Babel config out of the box.Fixed small cursor regression introduced in 0.0.33.
storage prop to PanelGroup to make it easier to persist layouts somewhere other than localStorage (e.g. like a Cookie).storage prop to PanelGroup to make it easier to persist layouts somewhere other than localStorage (e.g. a cookie). - #85Collapsible Panels will always call onCollapse on-mount regardless of their collapsed state.
Panels will always call onCollapse on-mount regardless of their collapsed state.* #75: Ensure Panel and PanelGroup callbacks are always called after mounting.
Panel and PanelGroup callbacks are always called after mounting.Panel and PanelGroup callbacks are always called after mounting. - #75Fix edge case when expanding a panel via imperative API that was collapsed by user drag
Added onLayout prop to PanelGroup to be called when group layout changes. Note that some form of debouncing is recommended before processing these val
PanelGroups configured to auto-save.onLayout prop to PanelGroup to be called when group layout changes. Note that some form of debouncing is recommended before processing these values (e.g. saving to a database).* #58: Add imperative collapse, expand, and resize methods to Panel. * #64: Disable pointer-events inside of Panels during resize. This avoid edge cas
collapse, expand, and resize methods to Panel.pointer-events inside of Panels during resize. This avoid edge cases like nested iframes.window.document. This more closely matches React's own check and avoids false positives for environments that alias window to some global object.collapse, expand, and resize methods to Panel. - #58pointer-events inside of Panels during resize. This avoids edge cases like nested iframes. - #64window.document. This more closely matches React's own check and avoids false positives for environments that alias window to some global object. - #57* #53: Avoid useLayoutEffect warning when server rendering. Render panels with default style of flex: 1 1 auto during initial render.
useLayoutEffect warning when server rendering. Render panels with default style of flex: 1 1 auto during initial render.* #4: Add collapsible and onCollapse props to Panel to support auto-collapsing panels that resize beyond their minSize value (similar to VS Code's pan
collapsible and onCollapse props to Panel to support auto-collapsing panels that resize beyond their minSize value (similar to VS Code's panel UX).Reduce style re-calc from resize-in-progress cursor style.
While a resize is active, the global cursor style now reliably overrides per-element styles (to avoid flickering if you drag over e.g. an anchor eleme
https://github.com/bvaughn/react-resizable-panels/issues/49: Change cursor based on min/max boundaries.
* #40: Add optional maxSize prop to Panel. * #41: Add optional onResize prop to Panel. This prop can be used (along with defaultSize) to persistence l
Replaced the "ew-resize" and "ns-resize" cursor style with "col-resize" and "row-resize".
"ew-resize" and "ns-resize" cursor styles with "col-resize" and "row-resize". - 0a255a5Add displayName to Panel, PanelGroup, PanelGroupContext, and PanelResizeHandle to work around ParcelJS scope hoisting renaming.
displayName to Panel, PanelGroup, PanelGroupContext, and PanelResizeHandle to work around ParcelJS scope hoisting renaming.0.0.20Corrupt TypeScript type definitions. Don't use this version.
Corrupt TypeScript type definitions. Don't use this version.
displayName to Panel, PanelGroup, PanelGroupContext, and PanelResizeHandle to work around ParcelJS scope hoisting renaming. - df32754Add optional style and tagName props to Panel, PanelGroup, and PanelResizeHandle to simplify custom styling.
style and tagName props to Panel, PanelGroup, and PanelResizeHandle to simplify custom styling.data-panel-group-direction attribute to PanelGroup and PanelResizeHandle to simplify custom drag handle styling.style and tagName props to Panel, PanelGroup, and PanelResizeHandle to simplify custom styling. - f92e041data-panel-group-direction attribute to PanelGroup and PanelResizeHandle to simplify custom drag handle styling.Panel and PanelGroup now use overflow: hidden style by default to avoid potential scrollbar flickers while resizing.
Panel and PanelGroup now use overflow: hidden style by default to avoid potential scrollbar flickers while resizing.overflow: hidden style by default for Panel and PanelGroup to avoid potential scrollbar flickers while resizing. - dd9b820Bug fix: Panel styles include flex-basis, flex-shrink, and overflow so that their sizes are not unintentionally impacted by their content.
Panel styles include flex-basis, flex-shrink, and overflow so that their sizes are not unintentionally impacted by their content.Panel styles to include flex-basis, flex-shrink, and overflow so that their sizes are not unintentionally impacted by their content. - 2f3f11fBug fix: Resize handle ARIA attributes now rendering proper min/max/now values for Window Splitter.
PanelContext in favor of adding data-resize-handle-active attribute to active resize handles. This attribute can be used to update the style for active handles.PanelContext in favor of adding data-resize-handle-active attribute to active resize handles. This attribute can be used to update the style for active handles. - #36* #30: PanelGroup uses display: flex rather than absolute positioning. This provides several benefits: (a) more responsive resizing for nested groups,
PanelGroup uses display: flex rather than absolute positioning. This provides several benefits: (a) more responsive resizing for nested groups, (b) no explicit width/height props, and (c) PanelResizeHandle components can now be rendered directly within PanelGroup (rather than as children of Panels).display: flex for PanelGroup rather than absolute positioning. This provides several benefits: (a) more responsive resizing for nested groups, (b) no explicit width/height props, and (c) PanelResizeHandle components can now be rendered directly within PanelGroup (rather than as children of Panels). - #30* #23: Fix small regression with autoSaveId that was introduced with non-deterministic useId ids.
autoSaveId that was introduced with non-deterministic useId ids.PanelGroup component now sets position: relative style by default, as well as an explicit height and width style.
useId (when available). Panel components no longer require a user-provided id prop and will also fall back to using useId when none is provided.PanelGroup component now sets position: relative style by default, as well as an explicit height and width style.useId (when available). Panel components no longer require a user-provided id prop and will also fall back to using useId when none is provided. - #18position: relative style on PanelGroup by default, as well as an explicit height and width style. - 59c3bd5Bug fix: https://github.com/bvaughn/react-resizable-panels/issues/19: Fix initial "jump" that could occur when dragging started.
Drag UX change: Reversing drag after dragging past the min/max size of a panel will no longer have an effect until the pointer overlaps with the resiz
Corrupt build artifact. Don't use this version.
* #13: PanelResizeHandle should declare "separator" role and implement the recommended "Window Splitter" pattern
PanelResizeHandle and implement the recommended "Window Splitter" pattern. - #13* #7: Support "touch" events for mobile compatibility.
Add PanelContext with activeHandleId property identifying the resize handle currently being dragged (or null). This enables more customized UI/UX when
PanelContext with an activeHandleId property identifying the resize handle currently being dragged (or null). This enables more customized UI/UX when resizing is in progress. - 8aed257Removed panelBefore and panelAfter props from PanelResizeHandle. PanelGroup now infers this based on position within the group.
panelBefore and panelAfter props from PanelResizeHandle. PanelGroup now infers this based on position within the group. - #5Fix TypeScript props type for PanelGroup's children prop.
PanelGroup's children prop.* #8: Added optional order prop to Panel to improve conditional rendering.
order prop to Panel to improve conditional rendering.order prop to Panel to improve conditional rendering. - #8* #3: Panels can be conditionally rendered within a group. PanelGroup will persist separate layouts for each combination of visible panels.
Panels can be conditionally rendered within a group. PanelGroup will persist separate layouts for each combination of visible panels.Panels within a group. PanelGroup will persist separate layouts for each combination of visible panels. - #3- Update documentation.
- Initial release.
One column per quarter.