Skip to content

Data grid - Row height

Customize the height of your rows.

Static row height

By default, the rows have a height of 52 pixels. This matches the normal height in the Material Design guidelines.

Use the rowHeight prop to change this default value, as shown below:

No rows
Desk
Commodity
Trader Name
Trader Email
Quantity

Rows per page:

0–0 of 0

Press Enter to start editing

Variable row height

If you need some rows to have different row heights this can be achieved using the getRowHeight prop. This function is called for each visible row and if the return value is a number then that number will be set as that row's rowHeight. If the return value is null or undefined, then the rowHeight prop will take effect for the given row.

id
username
age
1
@mohvuhe
28
2
@hovfe
21
3
@hapwipzu
28
4
@aknozum
45
5
@efigoclav
28

Rows per page:

1–5 of 5

Press Enter to start editing
const getRowHeight = React.useCallback(() => { ... }, []);

<DataGridPro getRowHeight={getRowHeight} />

Dynamic row height

Instead of a fixed row height, you can let the grid calculate the height of each row based on its content. To do so, return "auto" on the function passed to the getRowHeight prop.

<DataGrid getRowHeight={() => 'auto'} />

The following demo shows this feature in action:

id
username
age
bio
0
@row
51
Phasellus et ultrices dui. Nam ullamcorper ligula id consectetur auctor.
1
@diel
38
Phasellus et ultrices dui. Nulla venenatis justo non felis vulputate, eu mollis metus ornare.
2
@sulas
11
Aliquam dapibus, lorem vel mattis aliquet, purus lorem tincidunt mauris, in blandit quam risus sed ipsum. Phasellus et ultrices dui.
3
@eceudome
19
Vestibulum in massa nibh. Maecenas non felis venenatis, porta velit quis, consectetur elit. Pellentesque ac metus velit. Pellentesque ac metus velit. Pellentesque ac metus velit.
4
@efap
52
Vestibulum in massa nibh. Maecenas non felis venenatis, porta velit quis, consectetur elit.
5
@jazi
48
Nam ullamcorper ligula id consectetur auctor. Aliquam dapibus, lorem vel mattis aliquet, purus lorem tincidunt mauris, in blandit quam risus sed ipsum. Vestibulum in massa nibh.
6
@copozawo
18
Maecenas non felis venenatis, porta velit quis, consectetur elit. Vestibulum pulvinar aliquam turpis, ac faucibus risus varius a. Pellentesque ac metus velit.
7
@ej
57
Vestibulum pulvinar aliquam turpis, ac faucibus risus varius a. Pellentesque ac metus velit. Maecenas non felis venenatis, porta velit quis, consectetur elit.
8
@edliubo
47
Vestibulum commodo et odio a laoreet. Phasellus et ultrices dui. Phasellus et ultrices dui.

Rows per page:

1–100 of 200

The dynamic row height implementaion is based on a lazy approach, which means that the rows are measured as they are rendered. Because of this, you may see the size of the scrollbar thumb changing during scroll. This side effect happens because a row height estimation is used while a row is not rendered, then this value is replaced once the true measurement is obtained. You can configure the estimated value used by passing a function to the getEstimatedRowHeight prop. If not provided, the default row height of 52px is used as estimation. It's recommended to pass this prop if the content deviates too much from the default value. Note that, due to the implementation adopted, the virtualization of the columns is also disabled to force all columns to be rendered at the same time.

<DataGrid getRowHeight={() => 'auto'} getEstimatedRowHeight={() => 200} />
id
username
age
bio
0
@ripintuf
70
Phasellus et ultrices dui. Vestibulum commodo et odio a laoreet. Aliquam dapibus, lorem vel mattis aliquet, purus lorem tincidunt mauris, in blandit quam risus sed ipsum. 
1
@bo
19
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam cursus tincidunt auctor. Pellentesque ac metus velit. Vestibulum commodo et odio a laoreet. Nulla venenatis justo non felis vulputate, e 
2
@gaglo
46
Aliquam dapibus, lorem vel mattis aliquet, purus lorem tincidunt mauris, in blandit quam risus sed ipsum. Pellentesque ac metus velit. Aliquam dapibus, lorem vel mattis aliquet, purus lorem tincidunt  
3
@sidiwic
67
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum in massa nibh. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque ac metus velit. 
4
@enubuv
36
Nam ullamcorper ligula id consectetur auctor. Nam ullamcorper ligula id consectetur auctor. Vestibulum commodo et odio a laoreet. Maecenas non felis venenatis, porta velit quis, consectetur elit. 
5
@ci
21
Maecenas non felis venenatis, porta velit quis, consectetur elit. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus et ultrices dui. Aliquam dapibus, lorem vel mattis aliquet, purus l 

Rows per page:

1–10 of 10

Row density

Give your users the option to change the default row density to match their preferences—compact, standard, or comfortable. Density is calculated based on the rowHeight and/or headerHeight props, when present. See Density for details.

Row spacing

You can use the getRowSpacing prop to increase the spacing between rows. This prop is called with a GridRowSpacingParams object.

const getRowSpacing = React.useCallback((params: GridRowSpacingParams) => {
  return {
    top: params.isFirstVisible ? 0 : 5,
    bottom: params.isLastVisible ? 0 : 5,
  };
}, []);
No rows
Desk
Commodity
Trader Name
Trader Email
Quantity

Rows per page:

0–0 of 0

By default, setting getRowSpacing will change the marginXXX CSS properties of each row. To add a border instead, set rowSpacingType to "border" and customize the color and style.

<DataGrid
  getRowSpacing={...}
  rowSpacingType="border"
  sx={{ '& .MuiDataGrid-row': { borderTopColor: 'yellow', borderTopStyle: 'solid' } }}
/>

API