npm / ag-grid-enterprise
ag-grid-enterprise
What changed in ag-grid-enterprise 26 to 29, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-26.
24 breaking6 deprecations45 new APIs and options5 performance37 behavior and defaults1 tooling60 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initag-grid-enterprise 2951 changes
Breaking changes 3
The default server-side row model behavior changes to Infinite Scroll.
IRowNode is introduced as the public-facing interface instead of the internal RowNode object.
Legacy deprecated chart API members are removed.
Deprecations 1
The getCacheBlockState API method is deprecated.
New APIs and options 18
Axis label skipping can be turned off.
Charts support applying a delta options update and retrieving the current options state.
Chart title and subtitle padding can be applied from the outside edge rather than between the titles and chart area.
The items in the chart tool panel DATA tab can be customized.
The columnGroupShow type is opened up to accept additional values.
The columnMoved event arguments gain a finished property to identify the final drop position.
The legend item arrangement can be configured to override smart auto arrangement.
Legend item clicking can be disabled.
Integrated charts allow customizing pie chart sector label settings through the format panel.
Provided cell editor parameter interfaces are exported for use by developers.
Excel and CSV export can include row group footers, including group subtotal and grand total rows.
The rowSelected event gains a source property to distinguish user-driven from API-driven selection changes.
The selectionChanged event gains a source property to distinguish user-driven from API-driven selection changes.
Set Filter values can be displayed in a hierarchical list.
The source property is added to rowSelected and selectionChanged events to distinguish user-initiated from API-driven changes.
Treemap cell value labels can be formatted.
Treemap series can use color values directly from the data.
Unbalanced row groups become an optional behavior.
Behavior and default changes 13
The animateRows property becomes reactive in React.
Legend padding can be applied from the outside edge rather than between the legend and chart.
The chart tool panels button is enabled by default.
The column menu allows removing a column aggregation function.
Custom column layouts can be used in the column menu.
Legend items can be paginated when the chart area is too small.
Clipboard output can include the column header text once before multiple cell range values when all copied ranges include the same columns.
Pagination properties become reactive in React.
Pagination properties become reactive in React.
The server-side row model can display a single loading row when filtering instead of showing all grid rows as loading rows.
Set Filter supports complex objects as provided filter values.
Set Filter can interpret and group date values hierarchically by week, month, quarter, or year.
The gridOptions property becomes reactive in React.
Fixes and other changes 16
Filter popups resize correctly when opened, rather than only resizing the first time.
The event's eGui property is populated when opening filters displayed in the Filter Tool Panel.
Camel-case styles returned by getRowStyle are applied correctly, and CSS variables are added as properties.
CSS variables returned from getRowStyle are added as properties.
The callback is reevaluated after a transaction update.
Multi-filter parameters are passed to underlying floating filters.
The event property in onRowSelected parameters is populated when selecting a row with the checkbox or SPACE key.
Opening a popup no longer overrides the postProcessPopup callback or returns the popup to its original position.
Typing repeated letters selects the correct values.
Setting rowData to null displays the loading overlay consistently, including when calling setRowData(null).
The list's no-matches text updates when other filters change.
Searching matches raw values as well as formatted values.
An empty array cell value is represented by a (Blanks) item in the set filter list.
The source property value is passed through when updating DefaultColDefs.
Setting suppressFilterSearch to true in toolPanelParams hides Filter Search in the filters tool panel.
The tooltip background color can be modified using a CSS variable.
ag-grid-enterprise 2843 changes
Breaking changes 7
The all-modules package was removed; developers can no longer use it.
The all-modules package was removed; developers can no longer use it.
The colDef.comparator parameter is renamed from isInverted to isDescending.
The rowDataChanged event was removed in favor of rowDataUpdated.
The event is the replacement for rowDataChanged.
API members named for Secondary Columns were renamed to Pivot Columns.
The Server-Side Row Model was simplified by removing the Store concept.
New APIs and options 7
A fully compatible Angular Ivy package was published.
Themes gained extended CSS variable support.
Charts gained a listener for clicks on legend items.
Legend items can be limited by character count and display an ellipsis; hovering shows the full item value in a tooltip.
Chart legend items can be given a maximum width.
Generics were added for row data and cell values.
The group row for an expanded row group can float or stick at the top of the viewport while scrolling through its child rows.
Performance 2
Column and line chart series and tooltip rendering are faster with large numbers of data points.
Column aggregation calculation performance was improved.
Behavior and default changes 8
Bar and column series support number and time axes.
Column headers support word wrapping for multiline text and automatic height.
Row groups and tree data can be exported to Excel with expand/collapse support.
The callback can be invoked after a cell value edit, rather than only once on initial render.
Cells can be deselected from a selected range with CTRL+click or SHIFT+drag, as in Excel.
Different group columns can be sorted separately by clicking grouped column items in the row group panel.
A column can be hidden when grouping by dragging it from the grid header or columns tool panel list.
Server-side sorting and filtering can be used with the server-side row model without Infinite Scroll.
Fixes and other changes 19
Column tool panel areas and the row group panel use the correct role attribute instead of aria-role.
Fixed the mouse wheel changing the value when the number filter is focused.
Cell Class handling was improved to avoid a React memory leak.
Fixed a memory leak when using custom cell renderer components built on CellRendererFramework or pinnedRowCellRendererFramework.
Fixed grid cells firing dragStopped unnecessarily when clicked with range selection enabled.
Fixed copying cell values from collapsed group rows when groupHideOpenParents is true.
Fixed a memory leak when using a custom header component built on HeaderComponentFramework.
Fixed the horizontal scrollbar not appearing on hover or being draggable with Windows-style overlay scrolling in Edge.
Fixed clipped x- and y-axis labels in integrated line, area, and scatter charts.
Fixed the callback being called multiple times instead of once when an external filter changes.
The external filter presence callback is called consistently when new rows are loaded.
Fixed CTRL+Z/Y keyboard shortcuts not working with non-QWERTY keyboards.
The event now fires when removing a column from the row group panel changes its visibility.
Fixed the event firing twice instead of once on mousedown when enableRangeSelection is true.
The event property now retains the browser event when rowSelected fires.
Fixed secondary column order resetting when a secondary column is expanded after reordering.
Chart series highlight z-order behavior was improved.
Fixed locked columns rendering on the wrong side when their definitions are not at the corresponding end of the array.
Fixed the top-level checkbox being indeterminate and impossible to unselect when some rows are not selectable.
ag-grid-enterprise 2752 changes
Breaking changes 9
The chartType option is changed from an enum type to a string literal type.
The filterParams valueGetter receives valueGetterParams instead of only the node.
Removed the React Custom Cell Editor API method getPopupPosition().
A row node id of 0 is returned as a string rather than a number.
The callback is required when using SSRM with selection.
Removed the React Custom Cell Editor API method isPopup().
PAGE DOWN and PAGE UP scroll the viewport when focusing a cell taller than the available viewport.
New rows are kept by default in the Set Filter.
The Set Filter newRowsAction option defaults to keep.
Deprecations 5
KeyboardEvent.keyCode should be deprecated.
KeyboardEvent.which should be deprecated.
The refreshView API method is deprecated.
Renamed suppressCellSelection to suppressCellFocus to clarify that it suppresses cell focus styling, not selection.
Deprecated in favor of suppressCellFocus, which better describes its effect on cell focus rather than selection.
New APIs and options 10
Can position a column horizontally as start, end, or middle when ensuring it is visible.
Added the IMultiFilter interface to type public Multi Filter methods.
Added the ISetFilter interface to type public Set Filter methods.
Added a non-blank filter operation to all simple filters.
The API method accepts undefined as an input parameter.
Sparklines can display horizontal and vertical crosshair lines at the mouse pointer when hovered.
The sparkline tooltip can be displayed at a custom offset from the mouse cursor.
The default avg, count, min, max, and sum status bar components can have their titles changed and number values formatted.
Added rowNode, valueFormatter, and actual value parameters to textCustomComparator.
A custom tooltip hide timeout can be configured.
Performance 2
Cell class rule evaluation changes from O(n^2) to O(n).
Row class rules can be reevaluated without redrawing the entire row or recreating cell renderers.
Behavior and default changes 8
Excel export can preserve grid column groups as collapsible column groups.
Group column header values can be considered when performing column autosize.
Keyboard users can move columns in the column tool panel to the row groups, values, and column labels panels.
Copied ranges can be normalized and pasted in grid display order rather than selection order.
The context menu action supports multiple column header levels, including column groups and secondary columns.
The filter operation select element can be announced as a combobox by assistive technology.
Framework Components can be registered without using the xxxFramework naming convention.
The tooltipValueGetter return type accepts strings as well as custom objects for custom tooltip components.
Fixes and other changes 18
Calling api.onFilterChanged no longer throws when a Set Filter instance is requested for a column with filter=false.
Passing a non-string value no longer throws an exception.
Fixed automatic row height behavior, including an infinite measurement loop and incorrect sizing in several rendering cases.
Focus returns to the column header cell after the column menu is closed.
Fixed non-passive touchstart and wheel event listener console warnings when initially rendering a grid with charts enabled in Chrome.
Fixed Excel export issues affecting patternColor cell formatting.
Fixed the Set Filter treating an empty string as a separate item rather than including it in the (Blanks) item when provided values include null and an empty string.
Cell editor popup positioning now respects the getPopupPosition return value, allowing the popup to appear under the edited cell.
The getRowStyle API method typing now allows returning undefined.
Fixed chart data updates and rendering issues, including disappearing charts, missing rows, incorrect axes, and unsupported null or undefined values.
The configured default is now respected for infinite and partial server-side row models, limiting concurrent datasource requests as expected.
The navigateToNextHeader, tabToNextHeader, navigateToNextCell, and tabToNextCell callbacks can return null.
Fixed multiple ReactUI regressions affecting rendering, editing, filtering, pivoting, selection, sizing, and grid API calls.
Row dragging and dropping now updates row data when grid data is supplied through a state variable.
Fixed exceptions when expanding master rows with SSRM partial or full stores.
The API method accepts undefined as an input parameter.
Fixed console warnings when suppressAnimationFrame is true.
Fixed XML export so the exported header content includes style data.
ag-grid-enterprise 2632 changes
Breaking changes 5
Column hover became an opt-in feature.
The grid option was renamed from defaultGroupSortComparator to defaultGroupOrderComparator.
pinnedrowCellRenderer was removed.
The deprecated processChartOptions grid option callback was removed.
The unused old Tool Panel API was removed.
New APIs and options 10
ComponentSelectorResult was exported through @ag-grid-community/core.
Charts gained support for a custom axis tick period.
GridAPI gained getChartImageDataURL().
Sort directions can be set separately for each group column.
The GroupCellRendererParams interface was exported.
The status panel interface gained getFrameworkComponentInstance, setVisible, and isVisible properties.
Row grouping gained an option to maintain group order when sorting on non-group columns.
Charts gained series marker labels for Bubble, Scatter, and category series.
The setColumnWidth APIs were enhanced with a source parameter.
Tool Panel width can be set using current, minimum, maximum, and initial width settings.
Performance 1
The speed of React component rendering was improved.
Behavior and default changes 8
Users can resize or collapse the row groups, values, and column labels areas of the columns tool panel.
Component selectors can return direct references.
Comparators defined on columns can also sort group columns.
Custom cell renderers can be used with Group Footer Rows.
Sorting on non-grouped columns is supported when the group column is sorted with a custom comparator.
Row Auto Height support was enhanced.
Configuration of Row Grouping Display Types was simplified.
The set filter popup can be resized.
Tooling 1
Types on Angular interfaces were updated and improved.
Fixes and other changes 7
The gridApi method's return type was corrected to undefined, matching its actual return value.
resetColumnState now applies the initialHide column property value.
Long tooltips in master-detail grids are no longer clipped by the detail grid viewport and wrap across multiple lines.
The onGridSizeChanged event callback was given a type.
The console warning for the removed stopEditingWhenGridLosesFocus property now correctly identifies its replacement.
The browser context menu is suppressed when suppressContextMenu and preventDefaultOnContextMenu are both enabled.
valueGetter works in cells where groupHideOpenParent is used.