AdaptTable for Base UI

Row grouping in Base UI

Pass groupBy and rows fold into Base UI group headers with counts. Pass a list and each key nests inside the one before it, however deep the nesting goes.

groupAggregates adds per-group subtotals from the same mapper summaryRow uses, so every header totals its whole subtree and groupFooters closes each group with the same numbers.

Collapse state travels in the URL, and export writes the grouped sheet — outline levels and all — rather than the flat rows underneath it.

A group header is a table row with a spanning cell carrying the indent, a Base UI Checkbox for the tri-state group selection, and the engine's chevron inside a Base UI Button.

The code

import { DataTable } from "@adapttable/base-ui";

export function People({ rows, columns }) {
  return (
    <DataTable
      data={rows}
      columns={columns}
      rowKey={(row) => row.id}
      groupBy={["team", "status"]}
      groupFooters
      groupAggregates={(group) => ({
        budget: group.reduce(
          (sum, row) => sum + row.budget,
          0
        ),
      })}
    />
  );
}

Install

pnpm add @adapttable/base-ui @adapttable/core @base-ui/react

The same feature in the other kits

• Row grouping in Mantine — Rounded, friendly, filled controls
• Row grouping in MUI — Material elevation, uppercase actions
• Row grouping in Chakra — Soft teal, generous radius
• Row grouping in Ant Design — Compact, tinted header, crisp
• Row grouping in Radix — Radix Themes, iris accent
• Row grouping in shadcn — Monochrome, ring focus
• Row grouping in Tailwind — Unstyled — your own classes

More Base UI features

• Filtering in Base UI — Kit-native operators, date ranges, checklists, an AND/OR tree, chips.
• Column management in Base UI — Show, hide, reorder, pin and resize — from a menu you did not write.
• Column groups in Base UI — Spanning headers that collapse to a stub, a kept child, or a custom cell.
• Row selection in Base UI — A set of ids that survives paging, with bulk actions over it.
• Rows in Base UI — Pin, drag-reorder, merge cells, and a 3-dot menu per row.
• Inline cell editing in Base UI — Kit-native editors in the cell; every write goes through your handler.
• Nested tables in Base UI — A real table under a row — same engine, own columns, own keys.
• Export and print in Base UI — CSV, XLSX and PDF from one seam — plus a real print layout.
• Large datasets in Base UI — 100k rows, 40 columns, virtualized rows and columns, sticky chrome.
• Tree data in Base UI — Rows that contain rows — nesting, chevrons, keyboard traversal.
• Mobile cards in Base UI — Every row becomes a card on phones. Automatically, with the same state.
• Pivot tables in Base UI — Rows down the side, dimensions across the top, subtotals at every level.
• Saved views in Base UI — Name an arrangement, share it as a link, manage the list in place.
• Spreadsheet formulas in Base UI — Computed columns typed as formulas, errors reported in the cell.
• Right-to-left Base UI data table — Arabic strings, a flipped axis, and a popover that opens from the right edge.
• Live updates in Base UI — Rows change while you read them. Sort and selection hold.
• Accessible Base UI data table — Arrow-key focus, a visible ring, and every announcement shown as text.

Reference: row-grouping. More of this kit: AdaptTable for Base UI, or the live demo.