Liking cljdoc? Tell your friends :D

AG Grid options reference

Kebab-case option and event names for AG Grid 36.0.2, with the camelCase name each converts to. Keys are ordinary EDN — the full surface is reachable by assoc. For semantics of each option see the AG Grid docs: https://www.ag-grid.com/javascript-data-grid/grid-options/.

Grid Options

kebabcamelCasetypeinit-only?deprecated → replacementdescription
accented-sortaccentedSortboolean Set to true to specify that the sort should take accented characters into account. If this feature is turned on the sort will be slower.
active-overlayactiveOverlayany Display an overlay on demand. If provided takes precedence over the grid provided overlays.
active-overlay-paramsactiveOverlayParamsany Custom parameters to be supplied to the activeOverlay component in addition to IOverlayParams. Updating the params will trigger a refresh of the active overlay.
advanced-filter-builder-paramsadvancedFilterBuilderParamsobject Customise the parameters passed to the Advanced Filter Builder.
advanced-filter-paramsadvancedFilterParamsobject Customise the parameters passed to the Advanced Filter
advanced-filter-parentadvancedFilterParentobject DOM element to use as the parent for the Advanced Filter to allow it to appear outside of the grid.
agg-funcsaggFuncsobjectyes A map of 'function name' to 'function' for custom aggregation functions.
aggregate-only-changed-columnsaggregateOnlyChangedColumnsboolean When using change detection, only the updated column will be re-aggregated.
aligned-gridsalignedGridsfunction A list of grids to treat as Aligned Grids.
allow-context-menu-with-control-keyallowContextMenuWithControlKeyboolean Allows context menu to show, even when Ctrl key is held down.
allow-drag-from-columns-tool-panelallowDragFromColumnsToolPanelboolean Allow reordering and pinning columns by dragging columns from the Columns Tool Panel to the grid.
allow-show-change-after-filterallowShowChangeAfterFilterbooleanyes Set to true to have cells flash after data changes even when the change is due to filtering.
always-aggregate-at-root-levelalwaysAggregateAtRootLevelboolean When using aggregations, the grid will always calculate the root level aggregation value.
always-multi-sortalwaysMultiSortboolean Set to true to always multi-sort when the user clicks a column header, regardless of key presses.
always-pass-filteralwaysPassFilterobject Allows rows to always be displayed, even if they don't match the applied filtering.
always-show-horizontal-scrollalwaysShowHorizontalScrollboolean Set to true to always show the horizontal scrollbar.
always-show-vertical-scrollalwaysShowVerticalScrollboolean Set to true to always show the vertical scrollbar.
animate-column-resizinganimateColumnResizingboolean Set to true to animate changes to column width when auto-sizing the columns.
animate-rowsanimateRowsboolean Set to false to disable Row Animation which is enabled by default.
apply-quick-filter-before-pivot-or-aggapplyQuickFilterBeforePivotOrAggboolean When pivoting, Quick Filter is only applied on the pivoted data
async-transaction-wait-millisasyncTransactionWaitMillisnumber How many milliseconds to wait before executing a batch of async transactions.
auto-generate-column-defsautoGenerateColumnDefsobject When enabled, column definitions are generated automatically from the first row of rowData whenever row data is set or updated.
auto-group-column-defautoGroupColumnDefobject Allows specifying the group 'auto column' if you are not happy with the default. If grouping, this column definition is included as the first column in the grid. If not grouping, this column is not included.
auto-size-paddingautoSizePaddingnumber Number of pixels to add to a column width after the auto-sizing calculation.
auto-size-strategyautoSizeStrategyobjectyes Auto-size the columns when the grid is loaded. Can size to fit the grid width, fit a provided width, or fit the cell contents.
block-load-debounce-millisblockLoadDebounceMillisnumberyes How many milliseconds to wait before loading a block. Useful when scrolling over many blocks, as it prevents blocks loading until scrolling has settled.
cache-block-sizecacheBlockSizenumber How many rows for each block in the store, i.e. how many rows returned from the server at a time.
cache-overflow-sizecacheOverflowSizenumberyes How many extra blank rows to display to the user at the end of the dataset, which sets the vertical scroll and then allows the grid to request viewing more rows of data.
cache-quick-filtercacheQuickFilterbooleanyes Set to true to turn on the Quick Filter cache, used to improve performance when using the Quick Filter.
calculated-columnscalculatedColumnsobject Enables and configures Calculated Columns.
cell-fade-durationcellFadeDurationnumber Sets the duration in milliseconds of how long the "flashed" state animation takes to fade away after the timer set by cellFlashDuration has completed.
cell-flash-durationcellFlashDurationnumber Sets the duration in milliseconds of how long a cell should remain in its "flashed" state.
cell-selectioncellSelectionobject Configure cell selection.
chart-menu-itemschartMenuItemsobject Get chart menu items. Only applies when using AG Charts Enterprise.
chart-theme-overrideschartThemeOverridesobjectyes Chart theme overrides applied to all themes.
chart-themeschartThemesarrayyes The list of chart themes that a user can choose from in the chart panel.
chart-tool-panels-defchartToolPanelsDefobjectyes Allows customisation of the Chart Tool Panels, such as changing the tool panels visibility and order, as well as choosing which charts should be displayed in the chart panel.
clipboard-delimiterclipboardDelimiterstring Specify the delimiter to use when copying to clipboard.
col-resize-defaultcolResizeDefaultobject Set to 'shift' to have shift-resize as the default resize operation (same as user holding down Shift while resizing).
column-defscolumnDefsarray Array of Column / Column Group definitions.
column-hover-highlightcolumnHoverHighlightboolean Set to true to highlight columns by adding the ag-column-hover CSS class.
column-menucolumnMenuobjectyes Changes the display type of the column menu.
column-typescolumnTypesobject An object map of custom column types which contain groups of properties that column definitions can reuse by referencing in their type property.
componentscomponentsobjectyes A map of component names to components.
contextcontextanyyes Provides a context object that is provided to different callbacks the grid uses. Used for passing additional information to the callbacks used by your application.
copy-group-headers-to-clipboardcopyGroupHeadersToClipboardboolean Set to true to also include group headers when copying to clipboard using Ctrl + C clipboard.
copy-headers-to-clipboardcopyHeadersToClipboardboolean Set to true to also include headers when copying to clipboard using Ctrl + C clipboard.
create-chart-containercreateChartContainerobjectyes Callback to enable displaying the chart in an alternative chart container.
custom-chart-themescustomChartThemesobjectyes A map containing custom chart themes.
data-type-definitionsdataTypeDefinitionsobject An object map of cell data types to their definitions.
datasourcedatasourceobject Provide the datasource for infinite scrolling.
debounce-vertical-scrollbardebounceVerticalScrollbarbooleanyes Set to true to debounce the vertical scrollbar. Can provide smoother scrolling on slow machines.
debugdebugbooleanyes Set this to true to enable debug information from the grid and related components. Will result in additional logging being output, but very useful when investigating problems.
default-col-defdefaultColDefobject A default column definition. Items defined in the actual column definitions get precedence.
default-col-group-defdefaultColGroupDefobjectyes A default column group definition. All column group definitions will use these properties. Items defined in the actual column group definition get precedence.
default-csv-export-paramsdefaultCsvExportParamsobject A default configuration object used to export to CSV.
default-excel-export-paramsdefaultExcelExportParamsobject A default configuration object used to export to Excel.
delta-sortdeltaSortboolean When enabled, sorts only the rows added/updated by a transaction.
detail-cell-rendererdetailCellRendererany Provide a custom detailCellRenderer to use when a master row is expanded.
detail-cell-renderer-paramsdetailCellRendererParamsany Specifies the params to be used by the Detail Cell Renderer. Can also be a function that provides the params to enable dynamic definitions of the params.
detail-row-auto-heightdetailRowAutoHeightbooleanyes Set to true to have the detail grid dynamically change it's height to fit it's rows.
detail-row-heightdetailRowHeightnumberyes Set fixed height in pixels for each detail row.
does-external-filter-passdoesExternalFilterPassobject Should return true if external filter passes, otherwise false.
dom-layoutdomLayoutobject Switch between layout options: normal, autoHeight, print.
drag-and-drop-image-componentdragAndDropImageComponentanyyes Provide a custom drag and drop image component.
drag-and-drop-image-component-paramsdragAndDropImageComponentParamsany Customise the parameters provided to the Drag and Drop Image Component.
edit-typeeditTypeobject Set to 'fullRow' to enable Full Row Editing. Otherwise leave blank to edit one cell at a time.
embed-full-width-rowsembedFullWidthRowsboolean Set to true to have the Full Width Rows embedded in grid's main container so they can be scrolled horizontally.
enable-advanced-filterenableAdvancedFilterboolean Set to true to enable the Advanced Filter.
enable-browser-tooltipsenableBrowserTooltipsbooleanyes Set to true to use the browser's default tooltip instead of using the grid's Tooltip Component.
enable-cell-editing-on-backspaceenableCellEditingOnBackspaceboolean Forces Cell Editing to start when backspace is pressed. This is only relevant for MacOS users.
enable-cell-expressionsenableCellExpressionsbooleanyes Set to true to allow cell expressions.
enable-cell-spanenableCellSpanbooleanyes When true, enables the cell span feature allowing for the use of the colDef.spanRows property.
enable-cell-text-selectionenableCellTextSelectionboolean Set to true to be able to select the text within cells.
enable-chartsenableChartsboolean Set to true to Enable Charts.
enable-fill-handleenableFillHandleboolean v32.2 Use cellSelection.handle insteadSet to true to enable the Fill Handle.
enable-filter-handlersenableFilterHandlersbooleanyes Enable filter handlers for custom filter components.
enable-group-editenableGroupEditbooleanyes
enable-range-handleenableRangeHandleboolean v32.2 Use cellSelection.handle insteadSet to true to enable the Range Handle.
enable-range-selectionenableRangeSelectionboolean v32.2 Use cellSelection = true insteadSet to true to enable Range Selection.
enable-row-pinningenableRowPinningobject Determines whether manual row pinning is enabled via the row context menu.
enable-rtlenableRtlbooleanyes Set to true to operate the grid in RTL (Right to Left) mode.
enable-strict-pivot-column-orderenableStrictPivotColumnOrderboolean Resets pivot column order when impacted by filters, data or configuration changes
ensure-dom-orderensureDomOrderbooleanyes When true, the order of rows and columns in the DOM are consistent with what is on screen.
enter-navigates-verticallyenterNavigatesVerticallyboolean Set to true along with enterNavigatesVerticallyAfterEdit to have Excel-style behaviour for the Enter key.
enter-navigates-vertically-after-editenterNavigatesVerticallyAfterEditboolean Set to true along with enterNavigatesVertically to have Excel-style behaviour for the 'Enter' key.
excel-stylesexcelStylesarrayyes A list (array) of Excel styles to be used when exporting to Excel with styles.
exclude-children-when-tree-data-filteringexcludeChildrenWhenTreeDataFilteringboolean Set to true to override the default tree data filtering behaviour to instead exclude child nodes from filter results.
fill-handle-directionfillHandleDirectionobject v32.2 Use cellSelection.handle.direction insteadSet to 'x' to force the fill handle direction to horizontal, or set to 'y' to force the fill handle direction to vertical.
fill-operationfillOperationobject v32.2 Use cellSelection.handle.setFillValue insteadCallback to fill values instead of simply copying values or increasing number values using linear progression.
filter-handlersfilterHandlersobjectyes A map of filter handler key to filter handler function.
find-optionsfindOptionsobject Options for the Find feature.
find-search-valuefindSearchValuestring Text to find within the grid.
floating-filters-heightfloatingFiltersHeightnumber The height in pixels for the row containing the floating filters. If not specified, it uses the theme value of header-height.
focus-grid-inner-elementfocusGridInnerElementobject Allows overriding the element that will be focused when the grid receives focus from outside elements (tabbing into the grid).
formula-data-sourceformulaDataSourceobjectyes Provide a data source to control where formulas are stored and retrieved.
formula-funcsformulaFuncsobjectyes A map of 'function name' to 'function' for custom functions that are used for formulas.
full-width-cell-rendererfullWidthCellRendererany Provide your own cell renderer component to use for full width rows.
full-width-cell-renderer-paramsfullWidthCellRendererParamsany Customise the parameters provided to the fullWidthCellRenderer component.
functions-read-onlyfunctionsReadOnlyboolean If true, then row group, pivot and value aggregation will be read-only from the GUI. The grid will display what values are used for each, but will not allow the user to change the selection.
get-business-key-for-nodegetBusinessKeyForNodeobject Return a business key for the node. If implemented, each row in the DOM will have an attribute row-business-key='abc' where abc is what you return as the business key.
get-chart-toolbar-itemsgetChartToolbarItemsobjectyes Callback to be used to customise the chart toolbar items.
get-child-countgetChildCountobjectyes Allows setting the child count for a group row.
get-context-menu-itemsgetContextMenuItemsobject For customising the context menu.
get-data-pathgetDataPathobjectyes Callback to be used when working with Tree Data when treeData = true.
get-documentgetDocumentobject Allows overriding what document is used. Currently used by Drag and Drop (may extend to other places in the future). Use this when you want the grid to use a different document than the one available on the global scope. This can happen if docking out components (something which Electron supports)
get-full-row-edit-validation-errorsgetFullRowEditValidationErrorsobject Validates the Full Row Edit. Only relevant when editType="fullRow".
get-group-row-agggetGroupRowAggobject Callback to use when you need access to more then the current column for aggregation.
get-locale-textgetLocaleTextobjectyes A callback for localising text within the grid.
get-main-menu-itemsgetMainMenuItemsobjectyes For customising the main 'column header' menu.
get-row-classgetRowClassobject Callback version of property rowClass to set class(es) for each row individually. Function should return either a string (class name), array of strings (array of class names) or undefined for no class.
get-row-heightgetRowHeightobject Callback version of property rowHeight to set height for each row individually. Function should return a positive number of pixels, or return null/undefined to use the default row height.
get-row-idgetRowIdobjectyes Provide a pure function that returns a string ID to uniquely identify a given row. This enables the grid to work optimally with data changes and updates.
get-row-stylegetRowStyleobject Callback version of property rowStyle to set style for each row individually. Function should return an object of CSS values or undefined for no styles.
get-server-side-group-keygetServerSideGroupKeyobject SSRM Tree Data: Allows specifying group keys.
get-server-side-group-level-paramsgetServerSideGroupLevelParamsobjectyes Allows providing different params for different levels of grouping.
grand-total-rowgrandTotalRowobject When provided, an extra grand total row will be inserted into the grid at the specified position.
grid-idgridIdstringyes Provide a custom gridId for this instance of the grid. Value will be set on the root DOM node using the attribute grid-id as well as being accessible via the gridApi.getGridId() method.
group-agg-filteringgroupAggFilteringobject Set to determine whether filters should be applied on aggregated group values.
group-allow-unbalancedgroupAllowUnbalancedboolean Set to true to prevent the grid from creating a '(Blanks)' group for nodes which do not belong to a group, and display the unbalanced nodes alongside group nodes.
group-default-expandedgroupDefaultExpandednumber If grouping, set to the number of levels to expand by default, e.g. 0 for none, 1 for first level only, etc. Set to -1 to expand everything.
group-display-typegroupDisplayTypeobject Specifies how the results of row grouping should be displayed.
group-header-heightgroupHeaderHeightnumber The height in pixels for the rows containing header column groups. If not specified, it uses headerHeight.
group-hide-columns-until-expandedgroupHideColumnsUntilExpandedboolean When using groupDisplayType='multipleColumns' or groupHideOpenParents=true, hides group columns for levels
group-hide-open-parentsgroupHideOpenParentsboolean Set to true to hide parents that are open. When used with multiple columns for showing groups, it can give a more pleasing user experience.
group-hide-parent-of-single-childgroupHideParentOfSingleChildobject Enable to display the child row in place of the group row when the group only has a single child.
group-hierarchy-configgroupHierarchyConfigobject Custom group hierarchy components can be defined here for later use in colDef.groupHierarchy
group-lock-group-columnsgroupLockGroupColumnsnumberyes If grouping, locks the group settings of a number of columns, e.g. 0 for no group locking. 1 for first group column locked, -1 for all group columns locked.
group-maintain-ordergroupMaintainOrderboolean When true, sorting on non-group columns does not reorder groups; only the rows within
group-remove-lowest-single-childrengroupRemoveLowestSingleChildrenboolean v33.0.0 - use groupHideParentOfSingleChild: 'leafGroupsOnly' instead.Set to true to collapse lowest level groups that only have one child.
group-remove-single-childrengroupRemoveSingleChildrenboolean v33.0.0 - use groupHideParentOfSingleChild instead.Set to true to collapse groups that only have one child.
group-row-renderergroupRowRendererany Provide the Cell Renderer to use when groupDisplayType = 'groupRows'.
group-row-renderer-paramsgroupRowRendererParamsany Customise the parameters provided to the groupRowRenderer component.
group-selects-childrengroupSelectsChildrenboolean v32.2 Use rowSelection.groupSelects insteadWhen true, if you select a group, the children of the group will also be selected.
group-selects-filteredgroupSelectsFilteredboolean v32.2 Use rowSelection.groupSelects insteadIf using groupSelectsChildren, then only the children that pass the current filter will get selected.
group-suppress-blank-headergroupSuppressBlankHeaderboolean If true, and showing footer, aggregate data will always be displayed at both the header and footer levels. This stops the possibly undesirable behaviour of the header details 'jumping' to the footer on expand.
group-total-rowgroupTotalRowobject When provided, an extra row group total row will be inserted into row groups at the specified position, to display
header-heightheaderHeightnumber The height in pixels for the row containing the column label header. If not specified, it uses the theme value of header-height.
hide-padded-header-rowshidePaddedHeaderRowsboolean Hide any column header rows that would only contain padded groups.
iconsiconsobjectyes Icons to use inside the grid instead of the grid's default icons.
include-hidden-columns-in-advanced-filterincludeHiddenColumnsInAdvancedFilterboolean Hidden columns are excluded from the Advanced Filter by default.
include-hidden-columns-in-quick-filterincludeHiddenColumnsInQuickFilterboolean Hidden columns are excluded from the Quick Filter by default.
infinite-initial-row-countinfiniteInitialRowCountnumberyes How many extra blank rows to display to the user at the end of the dataset, which sets the vertical scroll and then allows the grid to request viewing more rows of data.
initial-group-order-comparatorinitialGroupOrderComparatorobject Allows default sorting of groups.
initial-stateinitialStateobjectyes Initial state for the grid. Only read once on initialization. Can be used in conjunction with api.getState() to save and restore grid state.
invalid-edit-value-modeinvalidEditValueModeobject Set to block to block the commit of invalid cell edits, keeping editors open.
is-apply-server-side-transactionisApplyServerSideTransactionobject Allows cancelling transactions.
is-external-filter-presentisExternalFilterPresentobject Grid calls this method to know if an external filter is present.
is-full-width-rowisFullWidthRowobject Tells the grid if this row should be rendered as full width.
is-group-open-by-defaultisGroupOpenByDefaultobject (Client-side Row Model only) Allows groups to be open by default.
is-row-masterisRowMasterobject Callback to be used with Master Detail to determine if a row should be a master row. If false is returned no detail row will exist for this row.
is-row-pinnableisRowPinnableobject Return true if the grid should allow the row to be manually pinned.
is-row-pinnedisRowPinnedobject Called for every row in the grid.
is-row-selectableisRowSelectableobject v32.2 Use rowSelection.isRowSelectable insteadCallback to be used to determine which rows are selectable. By default rows are selectable, so return false to make a row un-selectable.
is-row-valid-drop-positionisRowValidDropPositionobject Called by drag and drop when rows are dragged over another row to conditionally prevent dropping the dragged row on the hovered row.
is-server-side-groupisServerSideGroupobject SSRM Tree Data: Allows specifying which rows are expandable.
is-server-side-group-open-by-defaultisServerSideGroupOpenByDefaultobject Allows groups to be open by default.
keep-detail-rowskeepDetailRowsbooleanyes Set to true to keep detail rows for when they are displayed again.
keep-detail-rows-countkeepDetailRowsCountnumberyes Sets the number of details rows to keep.
load-theme-google-fontsloadThemeGoogleFontsboolean If your theme uses a font that is available on Google Fonts, pass true to load it from Google's CDN.
loadingloadingboolean Show or hide the loading overlay.
loading-cell-rendererloadingCellRendererany Provide your own loading cell renderer to use when data is loading via a DataSource or when a cell renderer is deferred.
loading-cell-renderer-paramsloadingCellRendererParamsany Params to be passed to the loadingCellRenderer component.
loading-cell-renderer-selectorloadingCellRendererSelectorobjectyes Callback to select which loading cell renderer to be used when data is loading via a DataSource or when a cell renderer is deferred.
loading-overlay-componentloadingOverlayComponentany Provide a custom loading overlay component.
loading-overlay-component-paramsloadingOverlayComponentParamsany Customise the parameters provided to the loading overlay component.
locale-textlocaleTextobjectyes A map of key->value pairs for localising text within the grid.
maintain-column-ordermaintainColumnOrderboolean Keeps the order of Columns maintained after new Column Definitions are updated.
master-detailmasterDetailboolean Set to true to enable Master Detail.
max-blocks-in-cachemaxBlocksInCachenumberyes How many blocks to keep in the store. Default is no limit, so every requested block is kept. Use this if you have memory concerns, and blocks that were least recently viewed will be purged when the limit is hit. The grid will additionally make sure it has all the blocks needed to display what is currently visible, in case this property is set to a low value.
max-concurrent-datasource-requestsmaxConcurrentDatasourceRequestsnumberyes How many requests to hit the server with concurrently. If the max is reached, requests are queued.
multi-sort-keymultiSortKeyobject Set to 'ctrl' to have multi sorting by clicking work using the Ctrl (or Command ⌘ for Mac) key.
navigate-to-next-cellnavigateToNextCellobject Allows overriding the default behaviour for when user hits navigation (arrow) key when a cell is focused. Return the next Cell position to navigate to or null to stay on current cell.
navigate-to-next-headernavigateToNextHeaderobject Allows overriding the default behaviour for when user hits navigation (arrow) key when a header is focused. Return the next Header position to navigate to or null to stay on current header.
no-rows-overlay-componentnoRowsOverlayComponentany Provide a custom no-rows overlay component.
no-rows-overlay-component-paramsnoRowsOverlayComponentParamsany Customise the parameters provided to the no-rows overlay component.
note-hide-delaynoteHideDelaynumber The delay in milliseconds before a note is hidden after the pointer leaves a noted cell or note popup.
note-show-delaynoteShowDelaynumber The delay in milliseconds before a note is shown when hovering a noted cell.
note-triggernoteTriggerobject Changes how existing notes are opened.
notes-data-sourcenotesDataSourceobject Provide a data source to control where notes are stored and retrieved.
overlay-componentoverlayComponentanyyes Provide a custom overlay component to be used for all grid provided overlays (loading, no rows, no matching rows, exporting etc).
overlay-component-paramsoverlayComponentParamsany Customise the parameters provided to the overlayComponent.
overlay-component-selectoroverlayComponentSelectorobjectyes Callback to dynamically provide a custom overlay component complete with custom params based on the selector params.
overlay-loading-templateoverlayLoadingTemplatestring Provide a HTML string to override the default loading overlay. Supports non-empty plain text or HTML with a single root element.
overlay-no-rows-templateoverlayNoRowsTemplatestring Provide a HTML string to override the default no-rows overlay. Supports non-empty plain text or HTML with a single root element.
paginate-child-rowspaginateChildRowsbooleanyes Set to true to have pages split children of groups when using Row Grouping or detail rows with Master Detail.
paginationpaginationboolean Set whether pagination is enabled.
pagination-auto-page-sizepaginationAutoPageSizeboolean Set to true so that the number of rows to load per page is automatically adjusted by the grid so each page shows enough rows to just fill the area designated for the grid. If false, paginationPageSize is used.
pagination-number-formatterpaginationNumberFormatterobjectyes Allows user to format the numbers in the pagination panel, i.e. 'row count' and 'page number' labels. This is for pagination panel only, to format numbers inside the grid's cells (i.e. your data), then use valueFormatter in the column definitions.
pagination-page-sizepaginationPageSizenumber How many rows to load per page. If paginationAutoPageSize is specified, this property is ignored.
pagination-page-size-selectorpaginationPageSizeSelectorarray Determines if the page size selector is shown in the pagination panel or not.
pagination-panelspaginationPanelsarray Controls which built-in components appear in the pagination panel and in what order.
pinned-bottom-row-datapinnedBottomRowDataarray Data to be displayed as pinned bottom rows in the grid.
pinned-top-row-datapinnedTopRowDataarray Data to be displayed as pinned top rows in the grid.
pivot-column-group-totalspivotColumnGroupTotalsobject When set and the grid is in pivot mode, automatically calculated totals will appear within the Pivot Column Groups, in the position specified.
pivot-default-expandedpivotDefaultExpandednumber If pivoting, set to the number of column group levels to expand by default, e.g. 0 for none, 1 for first level only, etc. Set to -1 to expand everything.
pivot-group-header-heightpivotGroupHeaderHeightnumber The height in pixels for the row containing header column groups when in pivot mode. If not specified, it uses groupHeaderHeight.
pivot-header-heightpivotHeaderHeightnumber The height in pixels for the row containing the columns when in pivot mode. If not specified, it uses headerHeight.
pivot-max-generated-columnspivotMaxGeneratedColumnsnumber The maximum number of generated columns before the grid halts execution. Upon reaching this number, the grid halts generation of columns
pivot-modepivotModeboolean Set to true to enable pivot mode.
pivot-panel-showpivotPanelShowobjectyes When to show the 'pivot panel' (where you drag rows to pivot) at the top. Note that the pivot panel will never show if pivotMode is off.
pivot-row-totalspivotRowTotalsobject When set and the grid is in pivot mode, automatically calculated totals will appear for each value column in the position specified.
pivot-suppress-auto-columnpivotSuppressAutoColumnbooleanyes If true, the grid will not swap in the grouping column when pivoting. Useful if pivoting using Server Side Row Model or Viewport Row Model and you want full control of all columns including the group column.
popup-parentpopupParentobject DOM element to use as the popup parent for grid popups (context menu, column menu etc).
post-process-popuppostProcessPopupobject Allows user to process popups after they are created. Applications can use this if they want to, for example, reposition the popup.
post-sort-rowspostSortRowsobject Callback to perform additional sorting after the grid has sorted the rows.
prevent-default-on-context-menupreventDefaultOnContextMenuboolean When using suppressContextMenu, you can use the onCellContextMenu function to provide your own code to handle cell contextmenu events.
process-auto-generated-column-defsprocessAutoGeneratedColumnDefsobject Callback fired after auto-generating column definitions and before they are applied to the grid.
process-cell-for-clipboardprocessCellForClipboardobject Allows you to process cells for the clipboard. Handy if for example you have Date objects that need to have a particular format if importing into Excel.
process-cell-from-clipboardprocessCellFromClipboardobject Allows you to process cells from the clipboard. Handy if for example you have number fields and want to block non-numbers from getting into the grid.
process-data-from-clipboardprocessDataFromClipboardobject Allows complete control of the paste operation, including cancelling the operation (so nothing happens) or replacing the data with other data.
process-file-inputprocessFileInputfunction Callback to handle files received via the file input overlay (drag-and-drop or file browser).
process-group-header-for-clipboardprocessGroupHeaderForClipboardobject Allows you to process group header values for the clipboard.
process-header-for-clipboardprocessHeaderForClipboardobject Allows you to process header values for the clipboard.
process-pivot-result-col-defprocessPivotResultColDefobject Callback for the mutation of the generated pivot result column definitions
process-pivot-result-col-group-defprocessPivotResultColGroupDefobject Callback for the mutation of the generated pivot result column group definitions
process-row-post-createprocessRowPostCreateobject Callback fired after the row is rendered into the DOM. Should not be used to initiate side effects.
process-unpinned-columnsprocessUnpinnedColumnsobjectyes Allows the user to process the columns being removed from the pinned section because the viewport is too small to accommodate them.
purge-closed-row-nodespurgeClosedRowNodesboolean When enabled, closing group rows will remove children of that row. Next time the row is opened, child rows will be read from the datasource again. This property only applies when there is Row Grouping or Tree Data.
quick-filter-matcherquickFilterMatcherobject Changes the matching logic for whether a row passes the Quick Filter.
quick-filter-parserquickFilterParserobject Changes how the Quick Filter splits the Quick Filter text into search terms.
quick-filter-textquickFilterTextstring Rows are filtered using this text as a Quick Filter.
reactive-custom-componentsreactiveCustomComponentsbooleanyesAs of v32 custom components are created reactively by default. Set this property to false to switch to the legacy way of declaring custom components imperatively.React only.
read-only-editreadOnlyEditboolean Set to true to stop the grid updating data after Edit, Clipboard and Fill Handle operations. When this is set, it is intended the application will update the data, eg in an external immutable store, and then pass the new dataset to the grid.
Note: rowNode.setDataValue() does not update the value of the cell when this is True, it fires onCellEditRequest instead.
refresh-after-group-editrefreshAfterGroupEditboolean When true, the grid re-evaluates the grouping hierarchy after editing a grouped column value,
remove-pivot-header-row-when-single-value-columnremovePivotHeaderRowWhenSingleValueColumnboolean Set to true to omit the value Column header when there is only a single value column.
rendering-moderenderingModeobject ** React only**.
reset-row-data-on-updateresetRowDataOnUpdateboolean When enabled, getRowId() callback is implemented and new Row Data is set, the grid will disregard all previous rows and treat the new Row Data as new data. As a consequence, all Row State (eg selection, rendered rows) will be reset.
row-bufferrowBuffernumber The number of rows rendered outside the viewable area the grid renders.
row-classrowClassarray CSS class(es) for all rows. Provide either a string (class name) or array of strings (array of class names).
row-class-rulesrowClassRulesobject Rules which can be applied to include certain CSS classes.
row-datarowDataarray Set the data to be displayed as rows in the grid.
row-drag-entire-rowrowDragEntireRowboolean Set to true to enable clicking and dragging anywhere on the row without the need for a drag handle.
row-drag-insert-delayrowDragInsertDelaynumber Used if rowDragManaged is enabled and treeData is enabled,
row-drag-managedrowDragManagedboolean Set to true to enable Managed Row Dragging.
row-drag-multi-rowrowDragMultiRowboolean Set to true to enable dragging multiple rows at the same time.
row-drag-textrowDragTextobjectyes A callback that should return a string to be displayed by the rowDragComp while dragging a row.
row-group-panel-showrowGroupPanelShowobject When to show the 'row group panel' (where you drag rows to group) at the top.
row-group-panel-suppress-sortrowGroupPanelSuppressSortboolean Set to true to suppress sort indicators and actions from the row group panel.
row-heightrowHeightnumber Default row height in pixels.
row-model-typerowModelTypeobjectyes Sets the row model type.
row-multi-select-with-clickrowMultiSelectWithClickboolean v32.2 Use rowSelection.enableSelectionWithoutKeys insteadSet to true to allow multiple rows to be selected using single click.
row-numbersrowNumbersobject Configure the Row Numbers Feature.
row-selectionrowSelectionobject Use the RowSelectionOptions object to configure row selection. The string values 'single' and 'multiple' are deprecated.
row-stylerowStyleobject The style properties to apply to all rows. Set to an object of key (style names) and values (style values).
scrollbar-widthscrollbarWidthnumberyes Tell the grid how wide in pixels the scrollbar is, which is used in grid width calculations. Set only if using non-standard browser-provided scrollbars, so the grid can use the non-standard size in its calculations.
selection-column-defselectionColumnDefobject Configure the selection column, used for displaying checkboxes.
send-to-clipboardsendToClipboardobject Allows you to get the data that would otherwise go to the clipboard. To be used when you want to control the 'copy to clipboard' operation yourself.
server-side-datasourceserverSideDatasourceobject Provide the serverSideDatasource for server side row model.
server-side-enable-client-side-sortserverSideEnableClientSideSortboolean When enabled, sorts fully loaded groups in the browser instead of requesting from the server.
server-side-initial-row-countserverSideInitialRowCountnumberyes Set how many loading rows to display to the user for the root level group.
server-side-only-refresh-filtered-groupsserverSideOnlyRefreshFilteredGroupsbooleanyes When enabled, only refresh groups directly impacted by a filter. This property only applies when there is Row Grouping & filtering is handled on the server.
server-side-pivot-result-field-separatorserverSidePivotResultFieldSeparatorstringyes Used to split pivot field strings for generating pivot result columns when pivotResultFields is provided as part of a getRows success.
server-side-sort-all-levelsserverSideSortAllLevelsboolean When enabled, always refreshes top level groups regardless of which column was sorted. This property only applies when there is Row Grouping & sorting is handled on the server.
show-opened-groupshowOpenedGroupboolean Shows the open group in the group column for non-group rows.
side-barsideBararray Specifies the side bar components.
single-click-editsingleClickEditboolean Set to true to enable Single Click Editing for cells, to start editing with a single click.
skip-header-on-auto-sizeskipHeaderOnAutoSizebooleanyes Set this to true to skip the headerName when autoSize is called by default.
sorting-ordersortingOrderarray v33 Use defaultColDef.sortingOrder insteadArray defining the order in which sorting occurs (if sorting is enabled). Values can be 'asc', 'desc' or null. For example: sortingOrder: ['asc', 'desc'].
ssrm-expand-all-affects-all-rowsssrmExpandAllAffectsAllRowsboolean Controls how expand/collapse operations affect all rows and group interactions.
status-barstatusBarobject Specifies the status bar components to use in the status bar.
stop-editing-when-cells-lose-focusstopEditingWhenCellsLoseFocusbooleanyes Set this to true to stop cell editing when grid loses focus.
style-noncestyleNoncestring The nonce attribute to set on style elements added to the document by
suppress-advanced-filter-evalsuppressAdvancedFilterEvalboolean As of v34, advanced filter no longer uses function evaluation, so this option has no effect.
suppress-agg-filtered-onlysuppressAggFilteredOnlyboolean Set to true so that aggregations are not impacted by filtering.
suppress-agg-func-in-headersuppressAggFuncInHeaderboolean When true, column headers won't include the aggFunc name, e.g. 'sum(Bank Balance)' will just be 'Bank Balance'.
suppress-animation-framesuppressAnimationFramebooleanyes When true, the grid will not use animation frames when drawing rows while scrolling. Use this if and only if the grid is working fast enough on all users machines and you want to avoid the temporarily empty rows.
suppress-auto-sizesuppressAutoSizebooleanyes Suppresses auto-sizing columns for columns. In other words, double clicking a column's header's edge will not auto-size.
suppress-browser-resize-observersuppressBrowserResizeObserverbooleanyesAs of v32.2 the grid always uses the browser's ResizeObserver, this grid option has no effect
suppress-cell-focussuppressCellFocusboolean If true, cells won't be focusable. This means keyboard navigation will be disabled for grid cells, but remain enabled in other elements of the grid such as column headers, floating filters, tool panels.
suppress-change-detectionsuppressChangeDetectionboolean Disables change detection.
suppress-clear-on-fill-reductionsuppressClearOnFillReductionboolean v32.2 Use cellSelection.suppressClearOnFillReduction insteadSet this to true to prevent cell values from being cleared when the Range Selection is reduced by the Fill Handle.
suppress-click-editsuppressClickEditboolean Set to true so that neither single nor double click starts editing.
suppress-clipboard-apisuppressClipboardApiboolean Set to true to stop the grid trying to use the Clipboard API, if it is blocked, and immediately fallback to the workaround.
suppress-clipboard-pastesuppressClipboardPasteboolean Set to true to turn off paste operations within the grid.
suppress-column-move-animationsuppressColumnMoveAnimationboolean If true, the ag-column-moving class is not added to the grid while columns are moving. In the default themes, this results in no animation when moving columns.
suppress-column-virtualisationsuppressColumnVirtualisationbooleanyes Set to true so that the grid doesn't virtualise the columns. For example, if you have 100 columns, but only 10 visible due to scrolling, all 100 will always be rendered.
suppress-content-visibility-autosuppressContentVisibilityAutobooleanyes Set to false to enable content-visibility: auto on the grid wrapper element. This improves performance by allowing the browser to skip rendering grids that are off screen, but may cause issues if your application depends on receiving resize events from hidden grids.
suppress-context-menusuppressContextMenuboolean Set to true to not show the context menu. Use if you don't want to use the default 'right click' context menu.
suppress-copy-rows-to-clipboardsuppressCopyRowsToClipboardboolean v32.2 Use rowSelection.copySelectedRows instead.Set to true to copy the cell range or focused cell to the clipboard and never the selected rows.
suppress-copy-single-cell-rangessuppressCopySingleCellRangesboolean v32.2 Use rowSelection.copySelectedRows instead.Set to true to copy rows instead of ranges when a range with only a single cell is selected.
suppress-csv-exportsuppressCsvExportboolean Prevents the user from exporting the grid to CSV.
suppress-cut-to-clipboardsuppressCutToClipboardboolean Set to true to block cut operations within the grid.
suppress-drag-leave-hides-columnssuppressDragLeaveHidesColumnsboolean If true, when you drag a column out of the grid (e.g. to the group zone) the column is not hidden.
suppress-excel-exportsuppressExcelExportboolean Prevents the user from exporting the grid to Excel.
suppress-expandable-pivot-groupssuppressExpandablePivotGroupsbooleanyes When enabled, pivot column groups will appear 'fixed', without the ability to expand and collapse the column groups.
suppress-field-dot-notationsuppressFieldDotNotationboolean If true, then dots in field names (e.g. 'address.firstLine') are not treated as deep references. Allows you to use dots in your field name if you prefer.
suppress-focus-after-refreshsuppressFocusAfterRefreshboolean Set to true to not set focus back on the grid after a refresh. This can avoid issues where you want to keep the focus on another part of the browser.
suppress-group-changes-column-visibilitysuppressGroupChangesColumnVisibilityobject Enable to prevent column visibility changing when grouped columns are changed.
suppress-group-rows-stickysuppressGroupRowsStickybooleanyes Set to true prevent Group Rows from sticking to the top of the grid.
suppress-header-focussuppressHeaderFocusboolean If true, header cells won't be focusable. This means keyboard navigation will be disabled for grid header cells, but remain enabled in other elements of the grid such as grid cells and tool panels.
suppress-horizontal-scrollsuppressHorizontalScrollboolean Set to true to never show the horizontal scroll. This is useful if the grid is aligned with another grid and will scroll when the other grid scrolls. (Should not be used in combination with alwaysShowHorizontalScroll.)
suppress-last-empty-line-on-pastesuppressLastEmptyLineOnPasteboolean Set to true to work around a bug with Excel (Windows) that adds an extra empty line at the end of ranges copied to the clipboard.
suppress-loading-overlaysuppressLoadingOverlaybooleanyesv32 - Deprecated. Use suppressOverlays=['loading'] or loading=false instead.Disables the 'loading' overlay.
suppress-maintain-unsorted-ordersuppressMaintainUnsortedOrderboolean Set to true to suppress sorting of un-sorted data to match original row data.
suppress-make-column-visible-after-un-groupsuppressMakeColumnVisibleAfterUnGroupboolean v33.0.0 - Use suppressGroupChangesColumnVisibility: 'suppressShowOnUngroup' instead.By default, when a column is un-grouped, i.e. using the Row Group Panel, it is made visible in the grid. This property stops the column becoming visible again when un-grouping.
suppress-max-rendered-row-restrictionsuppressMaxRenderedRowRestrictionbooleanyes By default the grid has a limit of rendering a maximum of 500 rows at once (remember the grid only renders rows you can see, so unless your display shows more than 500 rows without vertically scrolling this will never be an issue).
suppress-menu-hidesuppressMenuHideboolean Only recommended for use if columnMenu = 'legacy'.
suppress-middle-click-scrollssuppressMiddleClickScrollsboolean If true, middle clicks will result in click events for cells and rows. Otherwise the browser will use middle click to scroll the grid.
Note: Not all browsers fire click events with the middle button. Most will fire only mousedown and mouseup events, which can be used to focus a cell, but will not work to call the onCellClicked function.
suppress-model-update-after-update-transactionsuppressModelUpdateAfterUpdateTransactionboolean Prevents Transactions changing sort, filter, group or pivot state when transaction only contains updates.
suppress-movable-columnssuppressMovableColumnsboolean Set to true to suppress column moving, i.e. to make the columns fixed position.
suppress-move-when-column-draggingsuppressMoveWhenColumnDraggingboolean Set to true to suppress moving columns while dragging the Column Header. This option highlights the position where the column will be placed and it will only move it on mouse up.
suppress-move-when-row-draggingsuppressMoveWhenRowDraggingboolean Set to true to suppress moving rows while dragging the rowDrag waffle. This option highlights the position where the row will be placed and it will only move the row on mouse up.
suppress-multi-range-selectionsuppressMultiRangeSelectionboolean v32.2 Use cellSelection.suppressMultiRanges insteadIf true, only a single range can be selected.
suppress-multi-sortsuppressMultiSortboolean Set to true to suppress multi-sort when the user shift-clicks a column header.
suppress-no-rows-overlaysuppressNoRowsOverlaybooleanyes Set to true to prevent the no-rows overlay being shown when there is no row data.
suppress-overlayssuppressOverlaysarray List of provided overlay names to suppress. One of loading, noRows, noMatchingRows, exporting, fileInput.
suppress-pagination-panelsuppressPaginationPanelboolean If true, the default grid controls for navigation are hidden.
suppress-prevent-default-on-mouse-wheelsuppressPreventDefaultOnMouseWheelbooleanyes If true, mouse wheel events will be passed to the browser. Useful if your grid has no vertical scrolls and you want the mouse to scroll the browser page.
suppress-property-names-checksuppressPropertyNamesCheckbooleanyesAs of v33 gridOptions and columnDefs both have a context property that should be used for arbitrary user data. This means that column definitions and gridOptions should only contain valid properties making this property redundant.
suppress-row-click-selectionsuppressRowClickSelectionboolean v32.2 Use rowSelection.enableClickSelection insteadIf true, row selection won't happen when rows are clicked. Use when you only want checkbox selection.
suppress-row-deselectionsuppressRowDeselectionboolean v32.2 Use rowSelection.enableClickSelection insteadIf true, rows will not be deselected if you hold down Ctrl and click the row or press Space.
suppress-row-dragsuppressRowDragboolean Set to true to suppress row dragging.
suppress-row-group-hides-columnssuppressRowGroupHidesColumnsboolean v33.0.0 - Use suppressGroupChangesColumnVisibility: 'suppressHideOnGroup' instead.If true, when you drag a column into a row group panel the column is not hidden.
suppress-row-hover-highlightsuppressRowHoverHighlightboolean Set to true to not highlight rows by adding the ag-row-hover CSS class.
suppress-row-transformsuppressRowTransformbooleanyes Uses CSS top instead of CSS transform for positioning rows. Useful if the transform function is causing issues such as used in row spanning.
suppress-row-virtualisationsuppressRowVirtualisationbooleanyes Set to true so that the grid doesn't virtualise the rows. For example, if you have 100 rows, but only 10 visible due to scrolling, all 100 will always be rendered.
suppress-scroll-on-new-datasuppressScrollOnNewDataboolean When true, the grid will not scroll to the top when new row data is provided. Use this if you don't want the default behaviour of scrolling to the top every time you load new data.
suppress-scroll-when-popups-are-opensuppressScrollWhenPopupsAreOpenboolean When true, the grid will not allow mousewheel / touchpad scroll when popup elements are present.
suppress-server-side-full-width-loading-rowsuppressServerSideFullWidthLoadingRowboolean When true, the Server-side Row Model will not use a full width loading renderer, instead using the colDef loadingCellRenderer if present.
suppress-set-filter-by-defaultsuppressSetFilterByDefaultbooleanyes When using AG Grid Enterprise, the Set Filter is used by default when filter: true is set on column definitions.
suppress-start-edit-on-tabsuppressStartEditOnTabboolean Determine the behavior when navigating to the next/previous editable cell. Default is to begin editing the cell.
suppress-sticky-total-rowsuppressStickyTotalRowobject Suppress the sticky behaviour of the total rows, can be suppressed individually by passing 'grand' or 'group'.
suppress-touchsuppressTouchbooleanyes Disables touch support (but does not remove the browser's efforts to simulate mouse events on touch).
tab-indextabIndexnumberyes Change this value to set the tabIndex order of the Grid within your application.
tab-to-next-celltabToNextCellobject Allows overriding the default behaviour for when user hits Tab key when a cell is focused.
tab-to-next-grid-containertabToNextGridContainerobject Allows overriding the default behaviour when tabbing between core grid containers.
tab-to-next-headertabToNextHeaderobject Allows overriding the default behaviour for when user hits Tab key when a header is focused.
themethemeobject Theme to apply to the grid, or the string "legacy" to opt back into the
theme-css-layerthemeCssLayerstring The CSS layer that this theme should be rendered onto. When specified,
theme-style-containerthemeStyleContainerfunctionyes An element to insert style elements into when injecting styles into the
toolbartoolbarobject Specifies the toolbar items to use in the toolbar.
tooltip-hide-delaytooltipHideDelaynumber The delay in milliseconds that it takes for tooltips to hide once they have been displayed.
tooltip-interactiontooltipInteractionbooleanyes Set to true to enable tooltip interaction. When this option is enabled, the tooltip will not hide while the
tooltip-mouse-tracktooltipMouseTrackbooleanyes Set to true to have tooltips follow the cursor once they are displayed.
tooltip-show-delaytooltipShowDelaynumber The delay in milliseconds that it takes for tooltips to show up once an element is hovered over.
tooltip-show-modetooltipShowModeobject This defines when tooltip will show up for Cells, Headers and SetFilter Items.
tooltip-switch-show-delaytooltipSwitchShowDelaynumber The delay in milliseconds before a tooltip is shown when moving the pointer from one tooltip-enabled element to
tooltip-triggertooltipTriggerobjectyes The trigger that will cause tooltips to show and hide.
tree-datatreeDataboolean Set to true to enable the Grid to work with Tree Data.
tree-data-children-fieldtreeDataChildrenFieldstring The name of the field to use in a data item to retrieve the array of children nodes of a node when while using treeData=true.
tree-data-display-typetreeDataDisplayTypeobject Specifies how tree data should be displayed.
tree-data-parent-id-fieldtreeDataParentIdFieldstring The name of the field to use in a data item to find the parent node of a node when using treeData=true.
un-sort-iconunSortIconboolean v33 Use defaultColDef.unSortIcon insteadSet to true to show the 'no sort' icon.
undo-redo-cell-editingundoRedoCellEditingbooleanyes Set to true to enable Undo / Redo while editing.
undo-redo-cell-editing-limitundoRedoCellEditingLimitnumberyes Set the size of the undo / redo stack.
value-cachevalueCachebooleanyes Set to true to turn on the value cache.
value-cache-never-expiresvalueCacheNeverExpiresbooleanyes Set to true to configure the value cache to not expire after data updates.
viewport-datasourceviewportDatasourceobject To use the viewport row model you need to provide the grid with a viewportDatasource.
viewport-row-model-buffer-sizeviewportRowModelBufferSizenumberyes When using viewport row model, sets the buffer size for the viewport.
viewport-row-model-page-sizeviewportRowModelPageSizenumberyes When using viewport row model, sets the page size for the viewport.

Column Definitions

kebabcamelCasetypeinit-only?deprecated → replacementdescription
agg-funcaggFuncobject Name of function to use for aggregation. In-built options are: sum, min, max, count, avg, first, last. Also accepts a custom aggregation name or an aggregation function.
allow-formulaallowFormulaboolean Allow formulas to be entered and evaluated in this column.
allowed-agg-funcsallowedAggFuncsarray Aggregation functions allowed on this column e.g. ['sum', 'avg'].
auto-header-heightautoHeaderHeightboolean If enabled then the column header row will automatically adjust height to accommodate the size of the header cell.
auto-heightautoHeightboolean Set to true to have the grid calculate the height of a row based on contents of this column.
calculated-expressioncalculatedExpressionstring Expression used to calculate this column's value from other columns in the same row.
cell-aria-rolecellAriaRolestring Used for screen reader announcements - the role property of the cells that belong to this column.
cell-classcellClassobject Class to use for the cell. Can be string, array of strings, or function that returns a string or array of strings.
cell-class-rulescellClassRulesobject Rules which can be applied to include certain CSS classes.
cell-data-typecellDataTypeobject The data type of the cell values for this column.
cell-editorcellEditorany Provide your own cell editor component for this column's cells.
cell-editor-paramscellEditorParamsany Params to be passed to the cellEditor component.
cell-editor-popupcellEditorPopupboolean Set to true, to have the cell editor appear in a popup.
cell-editor-popup-positioncellEditorPopupPositionobject Set the position for the popup cell editor. Possible values are
cell-editor-selectorcellEditorSelectorobject Callback to select which cell editor to be used for a given row within the same column.
cell-renderercellRendererany Provide your own cell Renderer component for this column's cells.
cell-renderer-paramscellRendererParamsany Params to be passed to the cellRenderer component.
cell-renderer-selectorcellRendererSelectorobject Callback to select which cell renderer to be used for a given row within the same column.
cell-stylecellStyleobject An object of CSS values / or function returning an object of CSS values for a particular cell.
chart-data-typechartDataTypeobject Defines the chart data type that should be used for a column.
checkbox-selectioncheckboxSelectionobject v32.2 Use the new selection API instead. See GridOptions.rowSelection Set to true (or return true from function) to render a selection checkbox in the column.
col-idcolIdstring The unique ID to give the column. This is optional. If missing, the ID will default to the field.
col-spancolSpanobject By default, each cell will take up the width of one column. You can change this behaviour to allow cells to span multiple columns.
column-chooser-paramscolumnChooserParamsobject Params used to change the behaviour and appearance of the Column Chooser/Columns Menu tab.
column-group-showcolumnGroupShowobject Whether to only show the column when the group is open / closed. If not set the column is always displayed as part of the group.
comparatorcomparatorobject Override the default sorting order by providing a custom sort comparator, or a map of comparators for different SortTypes.
contextcontextany Context property that can be used to associate arbitrary application data with this column definition.
context-menu-itemscontextMenuItemsobject Customise the list of menu items available in the context menu.
date-componentdateComponentany Custom date selection component to be used in Date Filters and Date Floating Filters for this column.
date-component-paramsdateComponentParamsany The parameters to be passed to the dateComponent.
default-agg-funcdefaultAggFuncstring The name of the aggregation function to use for this column when it is enabled via the GUI.
dnd-sourcedndSourceobject boolean or Function. Set to true (or return true from function) to allow dragging for native drag and drop.
dnd-source-on-row-dragdndSourceOnRowDragobject Function to allow custom drag functionality for native drag and drop.
editableeditableobject Set to true if this column is editable, otherwise false. Can also be a function to have different rows editable.
enable-cell-change-flashenableCellChangeFlashboolean Set to true to flash a cell when it's refreshed.
enable-pivotenablePivotboolean Set to true if you want to be able to pivot by this column via the GUI. This will not block the API or properties being used to achieve pivot.
enable-row-groupenableRowGroupboolean Set to true if you want to be able to row group by this column via the GUI.
enable-show-values-asenableShowValuesAsboolean Shows the "Show Values As" submenu in the column menu.
enable-valueenableValueboolean Set to true if you want to be able to aggregate by this column via the GUI.
equalsequalsobject Custom comparator for values, used by renderer to know if values have changed. Cells whose values have not changed don't get refreshed.
fieldfieldobject The field of the row object to get the cell's data from.
filterfilterany Filter to use for this column.
filter-paramsfilterParamsany Params to be passed to the filter component specified in filter.
filter-value-getterfilterValueGetterobject Function or expression. Gets the value for filtering purposes.
flexflexnumber Equivalent to flex-grow in CSS. When flex is set on one or more
floating-filterfloatingFilterboolean Whether to display a floating filter for this column.
floating-filter-componentfloatingFilterComponentany The custom component to be used for rendering the floating filter.
floating-filter-component-paramsfloatingFilterComponentParamsany Params to be passed to floatingFilterComponent.
get-find-textgetFindTextobject When using Find with custom cell renderers, this allows providing a custom value to search within.
get-quick-filter-textgetQuickFilterTextobject A function to tell the grid what Quick Filter text to use for this column if you don't want to use the default (which is calling toString on the value).
group-hierarchygroupHierarchyarray Specify a grouping hierarchy for this column. This generates one or more virtual columns to group or pivot by when this column is grouped or pivoted.
group-row-editablegroupRowEditableobject Works like editable, but is evaluated only for group rows. When provided, group rows use
group-row-value-settergroupRowValueSetterobject Controls how a group row value edit is distributed to descendant rows.
header-checkbox-selectionheaderCheckboxSelectionobject v32.2 Use the new selection API instead. See GridOptions.rowSelection If true or the callback returns true, a 'select all' checkbox will be put into the header.
header-checkbox-selection-current-page-onlyheaderCheckboxSelectionCurrentPageOnlyboolean v32.2 Use the new selection API instead. See GridOptions.rowSelection If true, the header checkbox selection will only select nodes on the current page.
header-checkbox-selection-filtered-onlyheaderCheckboxSelectionFilteredOnlyboolean v32.2 Use the new selection API instead. See GridOptions.rowSelection If true, the header checkbox selection will only select filtered items.
header-classheaderClassobject CSS class to use for the header cell. Can be a string, array of strings, or function.
header-componentheaderComponentany The custom header component to be used for rendering the component header. If none specified the default AG Grid header component is used.
header-component-paramsheaderComponentParamsany The parameters to be passed to the headerComponent.
header-nameheaderNamestring The name to render in the column header. If not specified and field is specified, the field name will be used as the header name.
header-styleheaderStyleobject An object of CSS values / or function returning an object of CSS values for a particular header.
header-tooltipheaderTooltipstring Tooltip for the column header, headerTooltipValueGetter takes precedence if set.
header-tooltip-value-getterheaderTooltipValueGetterobject Callback that should return the string to use for a tooltip.
header-value-getterheaderValueGetterobject Function or expression. Gets the value for display in the header.
hidehideboolean Set to true for this column to be hidden.
iconsiconsobjectyes Icons to use inside the column instead of the grid's default icons. Leave undefined to use defaults.
initial-agg-funcinitialAggFuncobjectyes Same as aggFunc, except only applied when creating a new column. Not applied when updating column definitions.
initial-flexinitialFlexnumberyes Same as flex, except only applied when creating a new column. Not applied when updating column definitions.
initial-hideinitialHidebooleanyes Same as hide, except only applied when creating a new column. Not applied when updating column definitions.
initial-pinnedinitialPinnedobjectyes Same as pinned, except only applied when creating a new column. Not applied when updating column definitions.
initial-pivotinitialPivotbooleanyes Same as pivot, except only applied when creating a new column. Not applied when updating column definitions.
initial-pivot-indexinitialPivotIndexnumberyes Same as pivotIndex, except only applied when creating a new column. Not applied when updating column definitions.
initial-row-groupinitialRowGroupbooleanyes Same as rowGroup, except only applied when creating a new column. Not applied when updating column definitions.
initial-row-group-indexinitialRowGroupIndexnumberyes Same as rowGroupIndex, except only applied when creating a new column. Not applied when updating column definitions.
initial-show-values-asinitialShowValuesAsobjectyes Same as showValuesAs, except only applied when creating a new column.
initial-sortinitialSortobjectyes Same as sort, except only applied when creating a new column. Not applied when updating column definitions.
initial-sort-indexinitialSortIndexnumberyes Same as sortIndex, except only applied when creating a new column. Not applied when updating column definitions.
initial-value-indexinitialValueIndexnumberyes Same as valueIndex, except only applied when creating a new column. Not applied when updating column definitions.
initial-widthinitialWidthnumberyes Same as width, except only applied when creating a new column. Not applied when updating column definitions.
key-creatorkeyCreatorobject Function to return a string key for a value.
loading-cell-rendererloadingCellRendererany The renderer to be used while either
loading-cell-renderer-paramsloadingCellRendererParamsany Params to be passed to the loadingCellRenderer component.
loading-cell-renderer-selectorloadingCellRendererSelectorobject Callback to select which loading renderer to be used.
lock-pinnedlockPinnedboolean Set to true to block the user pinning the column, the column can only be pinned via definitions or API.
lock-positionlockPositionobject Lock a column to position to 'left' or'right' to always have this column displayed in that position. true is treated as 'left'
lock-visiblelockVisibleboolean Set to true to block making column visible / hidden via the UI (API will still work).
main-menu-itemsmainMenuItemsobject Customise the list of menu items available in the column menu.
max-widthmaxWidthnumber Maximum width in pixels for the cell.
menu-tabsmenuTabsarray Set to an array containing zero, one or many of the following options: 'filterMenuTab' \| 'generalMenuTab' \| 'columnsMenuTab'.
min-widthminWidthnumber Minimum width in pixels for the cell.
on-cell-clickedonCellClickedfunction Callback called when a cell is clicked.
on-cell-context-menuonCellContextMenufunction Callback called when a cell is right clicked.
on-cell-double-clickedonCellDoubleClickedfunction Callback called when a cell is double clicked.
on-cell-value-changedonCellValueChangedfunction Callback for after the value of a cell has changed, either due to editing or the application calling api.setValue().
pinnedpinnedobject Pin a column to one side: right or left. A value of true is converted to 'left'.
pivotpivotboolean Set to true to pivot by this column.
pivot-comparatorpivotComparatorobjectyes Only for CSRM, see SSRM Pivoting.
pivot-indexpivotIndexnumber Set this in columns you want to pivot by.
pivot-keyspivotKeysarray Never set this, it is used internally by grid when doing in-grid pivoting
pivot-total-column-idspivotTotalColumnIdsarray Never set this, it is used internally by grid when doing in-grid pivoting
pivot-value-columnpivotValueColumnobject Never set this, it is used internally by grid when doing in-grid pivoting
ref-datarefDataobject Provided a reference data map to be used to map column values to their respective value from the map.
resizableresizableboolean Set to false to disable resizing which is enabled by default.
row-dragrowDragobject boolean or Function. Set to true (or return true from function) to allow row dragging.
row-drag-textrowDragTextobject A callback that should return a string to be displayed by the rowDragComp while dragging a row.
row-grouprowGroupboolean Set to true to row group by this column.
row-group-indexrowGroupIndexnumber Set this in columns you want to group by.
row-grouping-hierarchyrowGroupingHierarchyarray deprecatedSpecify a grouping hierarchy for this column. This generates one or more virtual columns to group or pivot by when this column is grouped or pivoted.
row-spanrowSpanobject By default, each cell will take up the height of one row. You can change this behaviour to allow cells to span multiple rows.
show-disabled-checkboxesshowDisabledCheckboxesboolean v32.2 Use the new selection API instead. See GridOptions.rowSelection Set to true to display a disabled checkbox when row is not selectable and checkboxes are enabled.
show-row-groupshowRowGroupobjectyes Set to true to have the grid place the values for the group into the cell, or put the name of a grouped column to just show that group.
show-values-asshowValuesAsobject The active "Show Values As" mode for this column.
show-values-as-defshowValuesAsDefobject Per-column "Show Values As" configuration: precision, suppressHeaderIndicator, and user-provided
single-click-editsingleClickEditboolean Set to true to have cells under this column enter edit mode after single click.
sortsortobject Set the default sort.
sort-indexsortIndexnumber If sorting more than one column by default, specifies order in which the sorting should be applied.
sortablesortableboolean Set to false to disable sorting which is enabled by default.
sorting-ordersortingOrderarray An array defining the order in which sorting occurs (if sorting is enabled).
span-rowsspanRowsobject Set to true to automatically merge cells in this column with equal values. Provide a callback to specify custom merging logic.
suppress-auto-sizesuppressAutoSizeboolean Set to true if you do not want this column to be auto-resizable during 'size to contents' operations.
suppress-columns-tool-panelsuppressColumnsToolPanelboolean Set to true if you do not want this column or group to appear in the Columns Tool Panel.
suppress-fill-handlesuppressFillHandleboolean Set to true to prevent the fillHandle from being rendered in any cell that belongs to this column
suppress-filters-tool-panelsuppressFiltersToolPanelboolean Set to true if you do not want this column (filter) or group (filter group) to appear in the Filters Tool Panel.
suppress-floating-filter-buttonsuppressFloatingFilterButtonboolean If true, the button in the floating filter that opens the parent filter in a popup will not be displayed.
suppress-header-context-menusuppressHeaderContextMenuboolean Set to true to not display the column menu when the column header is right-clicked.
suppress-header-filter-buttonsuppressHeaderFilterButtonboolean Set to true to not display the filter button in the column header.
suppress-header-keyboard-eventsuppressHeaderKeyboardEventobject Suppress the grid taking action for the relevant keyboard event when a header is focused.
suppress-header-menu-buttonsuppressHeaderMenuButtonboolean Set to true if no menu button should be shown for this column header.
suppress-keyboard-eventsuppressKeyboardEventobject Allows the user to suppress certain keyboard events in the grid cell.
suppress-movablesuppressMovableboolean Set to true if you do not want this column to be movable via dragging.
suppress-navigablesuppressNavigableobject Set to true if this column is not navigable (i.e. cannot be tabbed into), otherwise false.
suppress-note-actionssuppressNoteActionsobject Set to true to suppress built-in note actions for this column.
suppress-pastesuppressPasteobject Pasting is on by default as long as cells are editable (non-editable cells cannot be modified, even with a paste operation).
suppress-size-to-fitsuppressSizeToFitboolean Set to true if you want this column's width to be fixed during 'size to fit' operations.
suppress-span-header-heightsuppressSpanHeaderHeightboolean Set to true if you don't want the column header for this column to span the whole height of the header container.
tool-panel-classtoolPanelClassobject CSS class to use for the tool panel cell. Can be a string, array of strings, or function.
tooltip-componenttooltipComponentany Provide your own tooltip component for the column.
tooltip-component-paramstooltipComponentParamsany The params used to configure tooltipComponent.
tooltip-component-selectortooltipComponentSelectorobject Callback to select which tooltip component to be used for a given row within the same column.
tooltip-fieldtooltipFieldobject The field of the tooltip to apply to the cell.
tooltip-value-gettertooltipValueGetterobject Callback that should return the string to use for a tooltip, tooltipField takes precedence if set.
typetypearray A comma separated string or array of strings containing ColumnType keys which can be used as a template for a column.
un-sort-iconunSortIconboolean Set to true if you want the unsorted icon to be shown when no sort is applied to this column.
use-value-formatter-for-exportuseValueFormatterForExportboolean By default, values are formatted using the column's valueFormatter when exporting data from the grid.
use-value-parser-for-importuseValueParserForImportboolean By default, values are parsed using the column's valueParser when importing data to the grid.
value-formattervalueFormatterobject A function or expression to format a value, should return a string.
value-gettervalueGetterobject Function or expression. Gets the value from your data for display.
value-indexvalueIndexnumber The position of this column in the order of value columns when aggregating in pivot mode.
value-parservalueParserobject Function or expression. Parses the value for saving.
value-settervalueSetterobject Function or expression. Sets the value into your data for saving. Return true if the data changed.
widthwidthnumber Initial width in pixels for the cell.
wrap-header-textwrapHeaderTextboolean If enabled then column header names that are too long for the column width will wrap onto the next line. Default false
wrap-textwrapTextboolean Set to true to have the text wrap inside the cell - typically used with autoHeight.

Column Groups

kebabcamelCasetypeinit-only?deprecated → replacementdescription
auto-header-heightautoHeaderHeightboolean If enabled then the column header row will automatically adjust height to accommodate the size of the header cell.
cell-aria-rolecellAriaRolestring Used for screen reader announcements - the role property of the cells that belong to this column.
childrenchildrenarray A list containing a mix of columns and column groups.
column-group-showcolumnGroupShowobject Whether to only show the column when the group is open / closed. If not set the column is always displayed as part of the group.
contextcontextany Context property that can be used to associate arbitrary application data with this column definition.
group-idgroupIdstring The unique ID to give the column. This is optional. If missing, a unique ID will be generated. This ID is used to identify the column group in the API.
header-classheaderClassobject CSS class to use for the header cell. Can be a string, array of strings, or function.
header-group-componentheaderGroupComponentany The custom header group component to be used for rendering the component header. If none specified the default AG Grid is used.
header-group-component-paramsheaderGroupComponentParamsany The params used to configure the headerGroupComponent.
header-nameheaderNamestring The name to render in the column header. If not specified and field is specified, the field name will be used as the header name.
header-styleheaderStyleobject An object of CSS values / or function returning an object of CSS values for a particular header.
header-tooltipheaderTooltipstring Tooltip for the column header, headerTooltipValueGetter takes precedence if set.
header-tooltip-value-getterheaderTooltipValueGetterobject Callback that should return the string to use for a tooltip.
header-value-getterheaderValueGetterobject Function or expression. Gets the value for display in the header.
main-menu-itemsmainMenuItemsobject Customise the list of menu items available in the column group header context menu (on right-click).
marry-childrenmarryChildrenboolean Set to true to keep columns in this group beside each other in the grid. Moving the columns outside of the group (and hence breaking the group) is not allowed.
open-by-defaultopenByDefaultboolean Set to true if this group should be opened by default.
pivot-keyspivotKeysarray Never set this, it is used internally by grid when doing in-grid pivoting
suppress-columns-tool-panelsuppressColumnsToolPanelboolean Set to true if you do not want this column or group to appear in the Columns Tool Panel.
suppress-filters-tool-panelsuppressFiltersToolPanelboolean Set to true if you do not want this column (filter) or group (filter group) to appear in the Filters Tool Panel.
suppress-header-context-menusuppressHeaderContextMenuboolean Set to true to not display the column menu when the column header is right-clicked.
suppress-header-keyboard-eventsuppressHeaderKeyboardEventobject Suppress the grid taking action for the relevant keyboard event when a header is focused.
suppress-sticky-labelsuppressStickyLabelboolean If true the label of the Column Group will not scroll alongside the grid to always remain visible.
tool-panel-classtoolPanelClassobject CSS class to use for the tool panel cell. Can be a string, array of strings, or function.
tooltip-componenttooltipComponentany Provide your own tooltip component for the column.
tooltip-component-paramstooltipComponentParamsany The params used to configure tooltipComponent.
wrap-header-textwrapHeaderTextboolean If enabled then column header names that are too long for the column width will wrap onto the next line. Default false

Events

kebabevent namehandler prop
advanced-filter-builder-visible-changedadvancedFilterBuilderVisibleChangedonAdvancedFilterBuilderVisibleChanged
async-transactions-flushedasyncTransactionsFlushedonAsyncTransactionsFlushed
batch-editing-startedbatchEditingStartedonBatchEditingStarted
batch-editing-stoppedbatchEditingStoppedonBatchEditingStopped
body-scrollbodyScrollonBodyScroll
body-scroll-endbodyScrollEndonBodyScrollEnd
bulk-editing-startedbulkEditingStartedonBulkEditingStarted
bulk-editing-stoppedbulkEditingStoppedonBulkEditingStopped
calculated-column-createdcalculatedColumnCreatedonCalculatedColumnCreated
calculated-column-expression-changedcalculatedColumnExpressionChangedonCalculatedColumnExpressionChanged
calculated-column-removedcalculatedColumnRemovedonCalculatedColumnRemoved
calculated-column-validation-state-changedcalculatedColumnValidationStateChangedonCalculatedColumnValidationStateChanged
cell-clickedcellClickedonCellClicked
cell-context-menucellContextMenuonCellContextMenu
cell-double-clickedcellDoubleClickedonCellDoubleClicked
cell-edit-requestcellEditRequestonCellEditRequest
cell-editing-startedcellEditingStartedonCellEditingStarted
cell-editing-stoppedcellEditingStoppedonCellEditingStopped
cell-focusedcellFocusedonCellFocused
cell-key-downcellKeyDownonCellKeyDown
cell-mouse-downcellMouseDownonCellMouseDown
cell-mouse-outcellMouseOutonCellMouseOut
cell-mouse-overcellMouseOveronCellMouseOver
cell-selection-changedcellSelectionChangedonCellSelectionChanged
cell-selection-delete-endcellSelectionDeleteEndonCellSelectionDeleteEnd
cell-selection-delete-startcellSelectionDeleteStartonCellSelectionDeleteStart
cell-value-changedcellValueChangedonCellValueChanged
chart-createdchartCreatedonChartCreated
chart-destroyedchartDestroyedonChartDestroyed
chart-options-changedchartOptionsChangedonChartOptionsChanged
chart-range-selection-changedchartRangeSelectionChangedonChartRangeSelectionChanged
column-everything-changedcolumnEverythingChangedonColumnEverythingChanged
column-group-openedcolumnGroupOpenedonColumnGroupOpened
column-header-clickedcolumnHeaderClickedonColumnHeaderClicked
column-header-context-menucolumnHeaderContextMenuonColumnHeaderContextMenu
column-header-mouse-leavecolumnHeaderMouseLeaveonColumnHeaderMouseLeave
column-header-mouse-overcolumnHeaderMouseOveronColumnHeaderMouseOver
column-menu-visible-changedcolumnMenuVisibleChangedonColumnMenuVisibleChanged
column-movedcolumnMovedonColumnMoved
column-pinnedcolumnPinnedonColumnPinned
column-pivot-changedcolumnPivotChangedonColumnPivotChanged
column-pivot-mode-changedcolumnPivotModeChangedonColumnPivotModeChanged
column-resizedcolumnResizedonColumnResized
column-row-group-changedcolumnRowGroupChangedonColumnRowGroupChanged
column-value-changedcolumnValueChangedonColumnValueChanged
column-visiblecolumnVisibleonColumnVisible
columns-resetcolumnsResetonColumnsReset
component-state-changedcomponentStateChangedonComponentStateChanged
context-menu-visible-changedcontextMenuVisibleChangedonContextMenuVisibleChanged
cut-endcutEndonCutEnd
cut-startcutStartonCutStart
displayed-columns-changeddisplayedColumnsChangedonDisplayedColumnsChanged
drag-cancelleddragCancelledonDragCancelled
drag-starteddragStartedonDragStarted
drag-stoppeddragStoppedonDragStopped
expand-or-collapse-allexpandOrCollapseAllonExpandOrCollapseAll
fill-endfillEndonFillEnd
fill-startfillStartonFillStart
filter-changedfilterChangedonFilterChanged
filter-modifiedfilterModifiedonFilterModified
filter-openedfilterOpenedonFilterOpened
filter-ui-changedfilterUiChangedonFilterUiChanged
find-changedfindChangedonFindChanged
first-data-renderedfirstDataRenderedonFirstDataRendered
floating-filter-ui-changedfloatingFilterUiChangedonFloatingFilterUiChanged
grid-columns-changedgridColumnsChangedonGridColumnsChanged
grid-pre-destroyedgridPreDestroyedonGridPreDestroyed
grid-readygridReadyonGridReady
grid-size-changedgridSizeChangedonGridSizeChanged
header-focusedheaderFocusedonHeaderFocused
model-updatedmodelUpdatedonModelUpdated
new-columns-loadednewColumnsLoadedonNewColumnsLoaded
pagination-changedpaginationChangedonPaginationChanged
paste-endpasteEndonPasteEnd
paste-startpasteStartonPasteStart
pinned-row-data-changedpinnedRowDataChangedonPinnedRowDataChanged
pinned-rows-changedpinnedRowsChangedonPinnedRowsChanged
pivot-max-columns-exceededpivotMaxColumnsExceededonPivotMaxColumnsExceeded
range-delete-endrangeDeleteEndonRangeDeleteEnd
range-delete-startrangeDeleteStartonRangeDeleteStart
range-selection-changedrangeSelectionChangedonRangeSelectionChanged
redo-endedredoEndedonRedoEnded
redo-startedredoStartedonRedoStarted
row-clickedrowClickedonRowClicked
row-data-updatedrowDataUpdatedonRowDataUpdated
row-double-clickedrowDoubleClickedonRowDoubleClicked
row-drag-cancelrowDragCancelonRowDragCancel
row-drag-endrowDragEndonRowDragEnd
row-drag-enterrowDragEnteronRowDragEnter
row-drag-leaverowDragLeaveonRowDragLeave
row-drag-moverowDragMoveonRowDragMove
row-editing-startedrowEditingStartedonRowEditingStarted
row-editing-stoppedrowEditingStoppedonRowEditingStopped
row-group-openedrowGroupOpenedonRowGroupOpened
row-resize-endedrowResizeEndedonRowResizeEnded
row-resize-startedrowResizeStartedonRowResizeStarted
row-selectedrowSelectedonRowSelected
row-value-changedrowValueChangedonRowValueChanged
selection-changedselectionChangedonSelectionChanged
sort-changedsortChangedonSortChanged
state-updatedstateUpdatedonStateUpdated
store-refreshedstoreRefreshedonStoreRefreshed
tool-panel-size-changedtoolPanelSizeChangedonToolPanelSizeChanged
tool-panel-visible-changedtoolPanelVisibleChangedonToolPanelVisibleChanged
tooltip-hidetooltipHideonTooltipHide
tooltip-showtooltipShowonTooltipShow
undo-endedundoEndedonUndoEnded
undo-startedundoStartedonUndoStarted
viewport-changedviewportChangedonViewportChanged
virtual-columns-changedvirtualColumnsChangedonVirtualColumnsChanged
virtual-row-removedvirtualRowRemovedonVirtualRowRemoved

Can you improve this documentation?Edit on GitHub

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts
Ctrl+kJump to recent docs
Move to previous article
Move to next article
Ctrl+/Jump to the search field
× close