logoAnt Design

⌘ K
  • Design
  • Development
  • Components
  • Blog
  • Resources
5.25.4
  • Ant Design of React
  • Changelog
    v5.25.4
  • Basic Usage
    • Getting Started
    • Usage with Vite
    • Usage with Next.js
      Updated
    • Usage with Umi
    • Usage with Rsbuild
    • Usage with Farm
    • Usage with Refine
  • Advanced
    • Customize Theme
    • CSS Compatible
    • Server Side Rendering
    • CSS Variables
      New
    • Use custom date library
    • Internationalization
    • Common Props
    • React 19 Compatibility
      New
  • Migration
    • V4 to V5
    • Less variables to Component Token
  • Other
    • Third-Party Libraries
    • Contributing
    • FAQ
ConfigProvider
Supported languages:
Adding new language

Internationalization

contributors
  • Use custom date libraryCommon Props

    Resources

    Ant Design X
    Ant Design Charts
    Ant Design Pro
    Pro Components
    Ant Design Mobile
    Ant Design Mini
    Ant Design Web3
    Ant Design Landing-Landing Templates
    Scaffolds-Scaffold Market
    Umi-React Application Framework
    dumi-Component doc generator
    qiankun-Micro-Frontends Framework
    Ant Motion-Motion Solution
    China Mirror 🇨🇳

    Community

    Awesome Ant Design
    Medium
    Twitter
    yuque logoAnt Design in YuQue
    Ant Design in Zhihu
    Experience Cloud Blog
    seeconf logoSEE Conf-Experience Tech Conference

    Help

    GitHub
    Change Log
    FAQ
    Bug Report
    Issues
    Discussions
    StackOverflow
    SegmentFault

    Ant XTech logoMore Products

    yuque logoYuQue-Document Collaboration Platform
    AntV logoAntV-Data Visualization
    Egg logoEgg-Enterprise Node.js Framework
    Kitchen logoKitchen-Sketch Toolkit
    Galacean logoGalacean-Interactive Graphics Solution
    xtech logoAnt Financial Experience Tech
    Theme Editor
    Made with ❤ by
    Ant Group and Ant Design Community

    The default language of antd is currently English. If you wish to use other languages, follow the instructions below.

    ConfigProvider

    antd provides a React Component ConfigProvider for configuring antd locale text globally.

    jsx
    import { ConfigProvider } from 'antd';
    import frFR from 'antd/locale/fr_FR';
    return (
    <ConfigProvider locale={frFR}>
    <App />
    </ConfigProvider>
    );

    You can see the complete configuration here: ConfigProvider.

    Note: fr_FR is the filename, the following table also follows the same rules.

    The following languages are currently supported:

    Supported languages:

    LanguageFilename
    Arabicar_EG
    Azerbaijaniaz_AZ
    Bulgarianbg_BG
    Bangla (Bangladesh)bn_BD
    Belarusianby_BY
    Catalanca_ES
    Czechcs_CZ
    Danishda_DK
    Germande_DE
    Greekel_GR
    English (United Kingdom)en_GB
    Englishen_US
    Spanishes_ES
    Basqueeu_ES
    Estonianet_EE
    Persianfa_IR
    Finnishfi_FI
    French (Belgium)fr_BE
    French (Canada)fr_CA
    French (France)fr_FR
    Irish (Ireland)ga_IE
    Galician (Spain)gl_ES
    Hebrewhe_IL
    Hindihi_IN
    Croatianhr_HR
    Hungarianhu_HU
    Armenianhy_AM
    Indonesianid_ID
    Italianit_IT
    Icelandicis_IS
    Japaneseja_JP
    Georgianka_GE
    Kurdish (Kurmanji)kmr_IQ
    Kannadakn_IN
    Kazakhkk_KZ
    Khmerkm_KH
    Koreanko_KR
    Lithuanianlt_LT
    Latvianlv_LV
    Macedonianmk_MK
    Malayalam (India)ml_IN
    Mongolianmn_MN
    Malay (Malaysia)ms_MY
    Burmesemy_MM
    Norwegiannb_NO
    Nepaline_NP
    Dutch (Belgium)nl_BE
    Dutchnl_NL
    Polishpl_PL
    Portuguese (Brazil)pt_BR
    Portuguesept_PT
    Romanianro_RO
    Russianru_RU
    Sinhalese / Sinhalasi_LK
    Slovaksk_SK
    Serbiansr_RS
    Sloveniansl_SI
    Swedishsv_SE
    Tamilta_IN
    Thaith_TH
    Turkishtr_TR
    Turkmentk_TK
    Urdu (Pakistan)ur_PK
    Ukrainianuk_UA
    Uzbek(latn)uz_UZ
    Vietnamesevi_VN
    Chinese (Simplified)zh_CN
    Chinese (Traditional)zh_HK
    Chinese (Traditional)zh_TW

    See more usage at ConfigProvider.

    Adding new language

    If your language is not in above list, feel free to create a locale package based on the en_US language pack and send us a pull request. For reference, you can refer to the pull request of adding the Azerbaijani language as a sample.

    Do it step by step:

    1. Fork antd and git clone to local, switch to feature branch, pull it to make sure it's up-to-date, create a new branch based on feature branch, all work will be done in it.

      bash
      git clone git@github.com:<your organization>/ant-design.git
      cd ant-design/
      git remote add upstream git@github.com:ant-design/ant-design.git
      git checkout -b <your new branch name> upstream/feature
    2. Add the language support for rc-picker, for example this.

    3. Add the language support for rc-pagination, for example this.

    4. Wait for rc-picker and rc-pagination to release the new version containing the above.

    5. Update the rc-picker and rc-pagination versions in antd and add the remaining other necessary content for the language. for example Azerbaijani PR.

    6. Add a test case for the language in index.test.tsx.

    7. update snapshots, you may also need to delete node_modules, lock files (yarn.lock or package-lock.json) and reinstall at first.

      bash
      npm run test -- components/locale -u
    8. Add the language to i18n list docs/react/i18n.en-US.md and docs/react/i18n.zh-CN.md.

    9. Watch out the CI status, and if it failed, look at the logs and make some changes until it all passes.

    10. Ok, now everything is ready for review.