Structure guide

Column Grouping data grid documentation

Column grouping lets you organize related columns under shared headers. You can also track which groups stay open and keep sibling columns moving together during drag.

What it means

Column grouping adds a shared band above related columns so users can read wider datasets without losing the structure of the data.

When to use it

Use it when the grid has clear column families such as quarterly numbers, actual versus forecast, or current versus previous state. It is most helpful once the table grows beyond a few standalone columns and users need help understanding the groups at a glance.

Implementation notes

Use the public callback when the page needs to remember which header bands a user opened. Do not group columns just because the schema can be grouped. Only add bands that improve scanning.

Relevant API

Start with columnGrouping.onColumnGroupToggled. Open the live API reference for types and defaults.