Localization

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

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

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

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

Example

RTL Support

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