Localization

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

Locale text

Use the theme to configure the locale text globally:

import { createTheme, ThemeProvider } from '@mui/material/styles';
import { zhCN } from '@mui/material/locale';

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

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

Example

{{"demo": "Locales.js"}}

:::warning The Data Grid and Data Grid Pro components have their own localization. :::

Supported locales

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 common 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.

RTL Support

Right-to-left languages such as Arabic, Persian, Hebrew, Kurdish, and others are supported. Follow this guide to use them.