MRT logoMaterial React Table

On This Page

    Column Ordering (DnD) Feature Guide

    Whether you just want to change the default column order in your table or let columns be reordered by dragging and dropping, Material React Table has a simple API for this.

    Relevant Table Options

    1
    boolean
    false
    MRT Column Ordering DnD Docs
    2
    boolean
    MRT Column Ordering DnD Docs
    3
    OnChangeFn<ColumnOrderState>
    TanStack Table Column Ordering Docs
    4
    OnChangeFn<MRT_Column<TData> | null>
    5
    OnChangeFn<MRT_Column<TData> | null>

    Relevant Column Options

    1
    boolean
    2
    boolean

    Relevant State

    1
    Array<string>
    []
    TanStack Table Column Ordering Docs
    2
    MRT_Column | null
    3
    MRT_Column | null

    Change the Default Column Order

    By Default, Material React Table will order the columns in the order they are defined in the columns table option. And Display Columns such as Actions, Selection, Expansion, etc., get added to either the beginning or the end of the table. You can customize all of this by defining your own columnOrder State and passing it either to the initialState or state props.

    The Column Order State is an array of string column ids, that come from the ids or accessorKeys that you defined in your column definitions.

    const table = useMaterialReactTable({
    data,
    columns,
    enableRowSelection: true,
    initialState: {
    columnOrder: [
    'name',
    'email',
    'phone',
    'city',
    'country',
    'mrt-row-select', //move the built-in selection column to the end of the table
    ],
    },
    });
    return <MaterialReactTable table={table} />;

    Manage Column Order State

    If you need to manage the columnOrder state yourself, you can do so in the state table option and onColumnOrderChange callback, but you will also need to initialize the columnOrder state yourself.

    const columns = [
    //...
    ];
    //easy shortcut to initialize the columnOrder state as array of column ids
    const [columnOrder, setColumnOrder] = useState(
    columns.map((c) => c.accessorKey), //array of column ids
    );
    const table = useMaterialReactTable({
    data,
    columns,
    enableRowSelection: true,
    state: {
    columnOrder,
    },
    onColumnOrderChange: setColumnOrder,
    });
    return <MaterialReactTable table={table} />;

    Enable Column Ordering with Drag and Drop

    Material React Table has a built-in drag and drop feature to reorder columns. This feature is enabled by passing the enableColumnOrdering table option.

    The ability for a column to have a drag and drop handle can be specified by setting the enableColumnOrdering option on the column.

    Demo

    Open StackblitzOpen Code SandboxOpen on GitHub
    DylanMurray261 Erdman FordEast DaphneKentucky
    RaquelKohler769 Dominic GroveColumbusOhio
    ErvinReinger566 Brakus InletSouth LindaWest Virginia
    BrittanyMcCullough722 Emie StreamLincolnNebraska
    BransonFrami32188 Larkin TurnpikeCharlestonSouth Carolina
    1-5 of 5

    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 () => [
    12 {
    13 accessorKey: 'firstName',
    14 header: 'First Name',
    15 },
    16 //column definitions...
    30 {
    31 accessorKey: 'state',
    32 enableColumnOrdering: false, //disable column ordering for this column,
    33 header: 'State',
    34 },
    35 ],
    36 [],
    37 );
    38
    39 const table = useMaterialReactTable({
    40 columns,
    41 data,
    42 enableColumnOrdering: true,
    43 });
    44
    45 return <MaterialReactTable table={table} />;
    46};
    47
    48export default Example;
    49

    View Extra Storybook Examples