Table Height

Control vertical overflow with height or maxHeight. Most apps should set one of them.

Fixed height

Use a fixed height when the table should always occupy the same vertical space. The header stays visible while rows scroll.

React TSX
<SimpleTable columns={columns} rows={rows} height="400px" />

Adaptive height (maxHeight)

Prefer maxHeight when row count varies — the table stays compact with few rows and grows up to the cap.

React TSX
<SimpleTable columns={columns} rows={rows} maxHeight="600px" />

Viewport or parent size

Use vh/vw or % when the table should track the viewport or a parent with a defined height.

React TSX
<SimpleTable columns={columns} rows={rows} height="50vh" />

External / window scroll

Omit height and maxHeight, then set scrollParent so the page (or a custom container) drives virtualization. The header pins to that scroll viewport. More detail on Infinite Scroll.

React TSX
<SimpleTable columns={columns} rows={rows} scrollParent="window" />

Example

Try different fixed heights below. Use Code or StackBlitz for the full example.

Current height: 400px

height vs maxHeight

height always fills the space you set. maxHeight shrinks with few rows. If both are set, height is ignored.

Rarely needed: customTheme header/footer height

Only for pagination tables with custom footers that need measured layout before paint. See Custom Theme.

Props

Height Configuration

PropertyRequiredDescriptionExample
height
string | number
Optional
Fixed height for the table container. The table scrolls internally with a sticky header. If both height and maxHeight are set, height is ignored.
maxHeight
string | number
Optional
Maximum height with adaptive sizing — the table shrinks when there are fewer rows, and grows up to this cap. Virtualization stays enabled.