npm / ag-grid-community
ag-grid-community
What changed in ag-grid-community 26 to 30, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-26.
42 breaking6 deprecations56 new APIs and options4 performance29 behavior and defaults1 tooling52 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initag-grid-community 3025 changes
Breaking changes 6
The legend is disabled by default for single-series Cartesian charts.
Column group header cells span multiple rows by default when other groups have more levels.
Horizontal sticky group column headers become the default behavior.
Group rows become sticky by default in row grouping, tree data, and master detail.
The main field defaults to using ES Modules.
The quick filter excludes values in hidden columns by default.
New APIs and options 13
A built-in numeric editor is available in the grid.
Cell data types and cell data type inference are available.
Events fire at the start and end of cell range delete operations.
A built-in checkbox cell editor is available for cell editing.
An API method is available to paste from the clipboard into the grid.
TypeScript can include column, editor, and renderer type information.
A date picker cell editor is available.
Excel export can suppress outlines for rows and columns.
Charts can be updated via the Grid API.
Grid instances can be identified via a unique id.
AG Grid modules can be registered on a per-grid basis.
A cut-operation start event is available, along with an end event.
The server-side row model supports group footer rows.
Behavior and default changes 5
The field property can use TData.
When pressing Shift+Enter, this option can focus the cell above.
When pressing Shift+Enter, this option can focus the cell above.
Excel export can preserve the collapsed or expanded state of row groups.
The event provides more information about tool panel visibility changes.
Fixes and other changes 1
Numeric values can be correctly parsed following a cell edit.
ag-grid-community 2961 changes
Breaking changes 14
Deprecated ag-grid-column components are removed.
Deprecated API methods are removed from the Column object.
The deprecated defaultGroupComparator API member is removed.
The deprecated key property is removed.
The deprecated addRowCompListener property is removed.
The deprecated suppressRefresh and autoHeight properties are removed.
Deprecated API members are removed from IGroupCellRendererParams.
The deprecated padding property is removed.
IRowNode is introduced as the public-facing interface instead of the internal RowNode object.
Legacy deprecated chart API members are removed.
Legacy deprecated methods are removed from gridApi and columnApi.
Legacy deprecated properties are removed from GridOptions and ColDefs.
Deprecated legacy SASS styles are removed.
The default Server-Side Row Model behaviour changes to Infinite Scroll.
Deprecations 1
The getCacheBlockState API method is deprecated.
New APIs and options 18
Axis label skipping can be turned off.
Integrated charts support applying a delta options update and retrieving the current options state.
Chart titles, subtitles, and legends can apply padding from the outside edge rather than between those elements and the chart area.
The chart tool panel DATA Tab items can be customized.
The column aggregation function can be removed from the column menu.
The columnGroupShow type now accepts open and closed.
Event arguments gain a finished property to identify the final place where a column was dropped.
Legend item arrangement can be configured to override smart auto arrangement.
Legend item clicks can be disabled.
Integrated charts can customize pie chart sector label settings via the format panel.
Provided cell editor parameter interfaces are exported for use by developers.
The event gains a source property to distinguish user-driven from API-driven selection changes.
The event gains a source property to distinguish user-driven from API-driven selection changes.
Set Filter values can be displayed in a hierarchical list.
Server-Side Row Model can display a single loading row when filtering instead of marking all grid rows as loading.
Treemap cell value labels can be formatted.
Treemap series can use color values directly from the data.
Unbalanced row groups become an optional behaviour.
Performance 1
Set filter updates avoid searching the entire list, improving performance with many items.
Behavior and default changes 10
animateRows becomes a reactive property in React.
The Chart Tool Panels Button is enabled by default.
The column menu pin submenu places No Pin first.
Set Filter supports complex objects as provided values.
Custom column layouts can be used in the column menu.
Set Filter can interpret and group date values by week, month, quarter, and year.
Legend items can be paginated when the chart area is too small.
Pagination properties become reactive in React.
Row group footers, including subtotal and grand total rows, can be exported to Excel and CSV.
The gridOptions property becomes reactive in React.
Fixes and other changes 17
Pie and doughnut charts are automatically padded so callout labels are not clipped.
The event is called when combination series types are changed.
Columns can be moved via drag and drop when AG Grid is contained in a Shadow DOM.
Filter popups resize correctly when opened, rather than resizing only the first time.
Frequent row updates no longer prevent typing in floating filter inputs.
Styles using camel case are applied correctly, and CSS variables are added as properties.
The callback is reevaluated after a transaction update.
Floating filters receive the filter parameters passed to the multi-filter.
Opening a popup no longer overrides the callback and returns the popup to its original position.
Typing repeated letters selects the correct values.
The event property is populated when selecting a row with a checkbox or SPACE key.
The Set Filter list shows a (Blanks) item for an empty array cell value.
Searching matches raw values as well as formatted values.
The list's no matches text updates when other filters change.
Columns can be moved via drag and drop when the grid is contained in a Shadow DOM.
The source property value is passed through when updating DefaultColDefs.
Setting suppressFilterSearch=true in toolPanelParams suppresses Filter Search in the filters tool panel.
ag-grid-community 2829 changes
Breaking changes 9
The all-modules package is removed.
The all-modules package is removed.
The colDef.comparator parameter is renamed from isInverted to isDescending.
The colDef.comparator parameter is renamed to isDescending.
API members are renamed from Secondary Columns to Pivot Columns.
The rowDataChanged event is removed in favor of rowDataUpdated.
The event is removed in favor of rowDataUpdated.
The rowDataUpdated event replaces rowDataChanged.
API members are renamed from Secondary Columns to Pivot Columns.
New APIs and options 5
A fully compatible Angular Ivy package is published.
The group row for an expanded row group can float or stick at the top of the viewport while scrolling through child rows.
Charts add a listener for legend item clicks.
Chart legend items can be given a maximum width.
Generics are added to row data and cell value typings.
Behavior and default changes 3
Column headers can support word wrapping for multi-line text and auto-height.
Cells can be deselected from a selected range by CTRL+clicking a cell or SHIFT+dragging to a cell.
Server-Side Sorting and Filtering are allowed without Infinite Scroll.
Fixes and other changes 12
Fixes the filter value changing when the mouse wheel is turned while the filter is focused.
Fixes keyboard shortcuts not working with non-QWERTY keyboards.
Fixes unnecessary dragStopped events when clicking a grid cell with range selection enabled.
Fixes copying collapsed group row cell values when groupHideOpenParents=true.
Fixes copying collapsed group row cell values when groupHideOpenParents=true.
Fixes the callback being called multiple times instead of once when the external filter changes.
The callback can be invoked after a cell value edit, not only on initial render.
Fixes the event not firing when removing a column from the row group panel changes its visibility.
Fixes the event firing twice instead of once on mousedown when enableRangeSelection=true.
Fixes the event property always being undefined when the rowSelected event is fired.
Fixes locked columns being rendered on the wrong side when their position in the column definitions does not match their locked side.
Fixes the horizontal scrollbar not appearing on hover or being draggable in Edge.
ag-grid-community 2729 changes
Breaking changes 6
The chartType option uses a string literal type instead of an enum type.
The filterParams valueGetter receives valueGetterParams instead of just the node.
The Custom Cell Editors API method is removed for React.
The callback is required when using SSRM with selection.
The Custom Cell Editors API method is removed for React.
The Set Filter newRowsAction option defaults to keep.
Deprecations 5
KeyboardEvent.keyCode is deprecated.
KeyboardEvent.which is deprecated.
The API method is deprecated.
Use this renamed option to suppress cell focus, rather than cell selection.
This option is deprecated and renamed to suppressCellFocus to better describe that it affects cell focus, not selection.
New APIs and options 8
The horizontal position of the column can be set to start, end, or middle.
A public interface is added to type Multi Filter methods.
A public interface is added to type Set Filter methods.
A non-blank filter operation is added to all simple filters.
A crosshair with horizontal and vertical lines can be displayed at the mouse pointer when hovering over the sparkline area.
The default avg, count, min, max, and sum components can have a custom title and formatted number value.
The comparator receives rowNode, valueFormatter, and the actual value as additional parameters.
A custom tooltip hide timeout can be set.
Performance 1
Row class rules can be reevaluated without redrawing the entire row and recreating cell renderers.
Behavior and default changes 6
Copied cell ranges can be normalized, and pasted values can follow their order in the grid rather than their selection order.
Keyboard users can move columns in the column tool panel to the row groups, values, and column labels panels.
Collapsible column groups can be exported as collapsible column groups in Excel.
Framework Components can be registered without using the xxxFramework suffix.
Group column header values can be considered when performing column autosize.
The return type accepts strings as well as custom objects for use with custom tooltip components.
Fixes and other changes 3
The context menu action works with multiple column header levels, including column groups and secondary columns.
The filter operation select element can be announced as a combobox by screen readers.
The scroll position is preserved when tabbing between integrated chart menu tabs.
ag-grid-community 2646 changes
Breaking changes 7
On mobile, cellMouseDown fires when a grid cell is tapped rather than waiting until touch ends.
Column hover became an opt-in feature.
The grid option was renamed from defaultGroupSortComparator to defaultGroupOrderComparator.
The pinnedrowCellRenderer API was removed.
The deprecated Integrated Charts grid option callback was removed.
A column is no longer grouped solely because rowGroupIndex is null or an integer when rowGroup is false.
The unused old Tool Panel API was removed.
New APIs and options 12
The component selector result interface is available through @ag-grid-community/core.
The ComponentSelectorResult interface is exported through @ag-grid-community/core.
Charts support a custom axis tick period.
An option was added to maintain group order when sorting on non-group columns.
The GridAPI adds getChartImageDataURL().
Sort directions can be set separately for each group column.
The GroupCellRendererParams interface is exported.
Bubble and Scatter charts support series marker labels.
Category series, including line, column, and area charts, support series marker labels.
The setColumnWidth APIs accept a source.
Tool Panel width can be set for current, minimum, maximum, and initial width.
Vue 3 reactivity and Composition API support was addressed.
Performance 2
With the infinite row model and zero displayed rows, calling this API no longer calls getRows unnecessarily.
React component rendering was made faster.
Behavior and default changes 5
Users can resize or collapse the row groups, values, and column labels areas of the columns tool panel.
Component selectors can return direct references.
Custom cell renderers can be used with Group Footer Rows.
Configuration of Row Grouping Display Types was simplified.
The set filter popup can be resized.
Tooling 1
The onGridSizeChanged event callback is typed.
Fixes and other changes 19
Row auto height now works with React components and styled components.
Calling setColumnDefs no longer leaves an empty selected range visible and inaccessible through the API.
Dynamically changing chart axes now updates them correctly.
Hidden chart series remain hidden when chart data is updated.
When pivoting, enabling a hidden value column from the columns tool panel adds it to the values list and displays it in the grid.
Long column menu items no longer cause the menu to be clipped at the rightmost column.
The grid interface includes createCrossFilterChart().
Calling ensureColumnVisible while the context menu is displayed now scrolls the viewport.
The gridApi method's return type now correctly reflects that it can return undefined.
The gridApi method returns undefined, not null, when no row node is found.
Sort comparators defined on columns can also sort group columns when sorting on non-grouped columns.
The interface includes getFrameworkComponentInstance, setVisible, and isVisible properties.
Long tooltips in master-detail grids are wrapped instead of clipped by the detail grid viewport.
resetColumnState now applies the initialHide column property value.
Row auto height support was enhanced, including fixes for framework-rendered and asynchronous components.
Applying column state with a modified rowGroupIndex updates grouping across multiple columns.
Refreshing column definitions preserves focus on a focused column header.
The warning for using the removed stopEditingWhenGridLosesFocus property now correctly identifies its replacement.
valueGetter works in cells where groupHideOpenParent is used.