Row Numbers Guide - Material React Table V2 Docs

Row Numbers Feature Guide

Material React Table has an easy to implement row number features. There are two row number modes that you can enable. You can have row numbers that are associated with the data in the table (original mode), or you can have row numbers that are just statically part of the table (static mode).

Relevant Table Options

#	Type	Default Value	More Info Links
1	boolean		Row Numbers Feature Guide

2	'original' \| 'static'	'original'

Enable Row Numbers (Static Mode)

In the default rowNumberDisplayMode (static), row numbers are just a static part of the table in their own column. They act like the row numbers in an excel spreadsheet. Sorting and filtering will not affect the row numbers.

Demo

Open Stackblitz Open Code Sandbox Open on GitHub

Primary

Secondary

Drop to group by

#	First Name	Last Name	Address	City	State
1	Dylan	Murray	261 Erdman Ford	East Daphne	Kentucky
2	Raquel	Kohler	769 Dominic Grove	Columbus	Ohio
3	Ervin	Reinger	566 Brakus Inlet	South Linda	West Virginia
4	Brittany	McCullough	722 Emie Stream	Lincoln	Nebraska
5	Branson	Frami	32188 Larkin Turnpike	Charleston	South Carolina

Rows per page

1-5 of 5

This example is written for MRT V2.

If your app is still using MRT V1, either Upgrade to MRT V2 or use the V1 Docs instead. (useMaterialReactTable only exists in V2)

Source Code

1import { useMemo } from 'react';
2import {
3  MaterialReactTable,
4  useMaterialReactTable,
5  type MRT_ColumnDef,
6} from 'material-react-table';
7import { data, type Person } from './makeData';
8
9const Example = () => {
10  const columns = useMemo<MRT_ColumnDef<Person>[]>(
11    //column definitions...
12    () => [
13      {
14        accessorKey: 'firstName',
15        header: 'First Name',
16      },
17      {
18        accessorKey: 'lastName',
19        header: 'Last Name',
20      },
21      {
22        accessorKey: 'address',
23        header: 'Address',
24      },
25      {
26        accessorKey: 'city',
27        header: 'City',
28      },
29      {
30        accessorKey: 'state',
31        header: 'State',
32      },
33    ],
34    [],
35    
36  );
37
38  const table = useMaterialReactTable({
39    columns,
40    data,
41    enableRowNumbers: true,
42    rowNumberDisplayMode: 'static', // default
43  });
44
45  return <MaterialReactTable table={table} />;
46};
47
48export default Example;
49

Enable Row Numbers (Original Mode)

Alternatively, use the "original" rowNumberDisplayMode to have row numbers linked to the original index of the data array. This means that when you search or filter, the same row numbers will stay with the same rows as data is sorted and filtered.