Data Grid - Localization

The Data Grid allows to support users from different locales, with formatting, RTL, and localized strings.

The default locale of Material-UI is English (United States). If you want to use other locales, follow the instructions below.

Translation keys

You can use the localeText prop to pass in your own text and translations. You can find all the translation keys supported in the source in the GitHub repository. In the following example, the labels of the density selector are customized.

<DataGrid
  {...data}
  localeText={{
    toolbarDensity: 'Size',
    toolbarDensityLabel: 'Size',
    toolbarDensityCompact: 'Small',
    toolbarDensityStandard: 'Medium',
    toolbarDensityComfortable: 'Large',
  }}
  components={{
    Toolbar: GridToolbar,
  }}
/>

Locale text

The default locale of Material-UI is English (United States).

You can use the theme to configure the locale text:

import { createTheme, ThemeProvider } from '@material-ui/core/styles';
import { DataGrid, bgBG } from '@mui/x-data-grid';

const theme = createTheme(
  {
    palette: {
      primary: { main: '#1976d2' },
    },
  },
  bgBG,
);

<ThemeProvider theme={theme}>
  <DataGrid />
</ThemeProvider>;

Note that createTheme accepts any number of arguments. If you are already using the translations of the core components, you can add bgBG as a new argument. The same import works for DataGridPro as it's an extension of DataGrid.

import { createTheme, ThemeProvider } from '@material-ui/core/styles';
import { DataGrid, bgBG } from '@mui/x-data-grid';
import { bgBG as coreBgBG } from '@material-ui/core/locale';

const theme = createTheme(
  {
    palette: {
      primary: { main: '#1976d2' },
    },
  },
  bgBG,
  coreBgBG,
);

<ThemeProvider theme={theme}>
  <DataGrid />
</ThemeProvider>;

If you want to pass language translations directly to the grid without using createTheme and ThemeProvider, you can directly load the language translations from the @mui/x-data-grid or @mui/x-data-grid-pro package.

import { DataGrid, nlNL } from '@mui/x-data-grid';

<DataGrid localeText={nlNL.props.MuiDataGrid.localeText} />;

Supported locales

Locale	BCP 47 language tag	Import name
Arabic (Sudan)	ar-SD	arSD
Bulgarian	bg-BG	bgBG
Czech	cs-CZ	csCZ
Dutch	nl-NL	nlNL
English (United States)	en-US	enUS
French	fr-FR	frFR
German	de-DE	deDE
Greek	el-GR	elGR
Italian	it-IT	itIT
Japanese	ja-JP	jaJP
Polish	pl-PL	plPL
Portuguese (Brazil)	pt-BR	ptBR
Russian	ru-RU	ruRU
Slovak	sk-SK	skSK
Spanish (Spain)	es-ES	esES
Turkish	tr-TR	trTR
Ukraine	uk-UA	ukUA

You can find the source in the GitHub repository.

To create your own translation or to customize the English text, copy this file to your project, make any changes needed and import the locale from there.

Please do consider contributing new translations back to Material-UI by opening a pull request. However, Material-UI aims to support the 100 most popular locales. We might not accept contributions for locales that are not frequently used, for instance, gl-ES that has "only" 2.5 million native speakers. See the Docs for more details.

API

• DataGrid
• DataGridPro