Skip to content

🎉 Material UI v5 is out! Head to the migration guide to get started.


Localization (also referred to as "l10n") is the process of adapting a product or content to a specific locale or market.

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 '@material-ui/core/styles';
import { zhCN } from '@material-ui/core/locale';

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

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




11-20 的 2000

Supported locales

Locale BCP 47 language tag Import name
Armenian hy-AM hyAM
Azerbaijani az-AZ azAZ
Bulgarian bg-BG bgBG
Catalan ca-ES caES
Chinese (Simplified) zh-CN zhCN
Czech cs-CZ csCZ
Dutch nl-NL nlNL
English (United States) en-US enUS
Estonian et-EE etEE
Finnish fi-FI fiFI
French fr-FR frFR
German de-DE deDE
Hebrew he-IL heIL
Hindi hi-IN hiIN
Hungarian hu-HU huHU
Icelandic is-IS isIS
Indonesian id-ID idID
Italian it-IT itIT
Japanese ja-JP jaJP
Korean ko-KR koKR
Persian fa-IR faIR
Polish pl-PL plPL
Portuguese (Brazil) pt-BR ptBR
Portuguese pt-PT ptPT
Romanian ro-RO roRO
Russian ru-RU ruRU
Slovak sk-SK skSK
Spanish es-ES esES
Swedish sv-SE svSE
Turkish tr-TR trTR
Ukrainian uk-UA ukUA
Vietnamese vi-VN viVN

You can find the source in the GitHub repository.

To create your own translation, or to customise 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.

RTL Support

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