Skip to main content
By the end of this guide, you’ll know how to configure Link to display in your users’ preferred language — automatically matching their device locale or specifying a particular language.
Before you start

​
Overview

This guide explains how to configure Link (the Mesh SDK) to support multiple languages for a localized user experience. The language parameter allows you to automatically match the user’s device/browser language, or specify a particular language and locale.

​
Possible Values

  • <BCP 47 code>: A specific language code enumerated as the 2 digit language identifier (eg. “fr” for French) and the 2 digit region identifier (eg. “CA” for Canada), combined as “fr-CA”. Alternatively, the SDK will accept an input of only the language (eg. “fr”).
  • If the indicated language (eg. “fr”) is followed by a region code (eg. “CA”) that is not recognized or supported for that language, Link will fall back to the default translation for that language, if available (eg. “fr-FR”). If no translation for the language is available, Link will default to “en-US” (English, US).
  • If you do not provide a value for the parameter, or if you provide a value for a language that is not supported, Link will default to “en-US” (English, US).
  • system: Link will detect the default language on the user’s browser and/or device and display Link in that language. If it is an unsupported value, it will fallback to another locale for that language, or it will fallback to the global default of en-US.

​
Implementation

When you initialize Link in your application, use the language parameter to specify the desired language behavior. 
const connection = createLink({
  ...
  language: 'system',
  ...
})

let settings = LinkSettings(language: "system",
                            ...)

val configuration = LinkConfiguration(
  ...
  language = "system",
  ...
)

return <...
        settings={{
          language: 'system',
          ...
        }}

final result = await MeshSdk.show(
  context,
  configuration: MeshConfiguration(
    language: 'system',
    ...
      ),

​
2. Test your implementation

Thoroughly test your implementation to ensure a seamless experience for your users:
  • Verify that Link displays correctly in the languages you intend to support.
  • Please let your Mesh representative know if you spot any incorrectly translated words or phrases, or any layout issues (for example with right-to-left or character-based languages).

​
Currently supported languages

If you need a language that isn’t listed below, reach out to your Mesh representative and we’ll get it added.
StatusLanguageRegionLocale code
livesystemsystem
liveEnglishUnited States (global default)en-US
liveChinese/Mandarin (Simplified)China (zh default)zh-CN
liveFinnishFinlandfi-FI
liveFrenchFrance (fr default)fr-FR
liveGermanGermanyde-DE
liveHindiIndiahi-IN
liveIndonesianIndonesiaid-ID
liveJapaneseJapanja-JP
liveMalayMalaysiams-MY
livePolishPolandpl-PL
livePortuguesePortugal (pt default)pt-PT
liveRussianRussiaru-RU
liveSpanishUnited States (es default)es-US
liveThaiThailandth-TH
liveTurkishTurkeytr-TR
liveUkrainianThe Ukraineuk-UA
liveUzbekUzbekistanuz-UZ
liveVietnameseVietnamvi-VN
backlogArabicEgyptar-EG
backlogChinese/Mandarin (Traditional)United Stateszh-US
backlogChineseHong Kongzh-HK
backlogChineseTaiwanzh-TW
backlogCzechCzech Republiccs-CZ
backlogDanishDenmarkda-DK
backlogDutch, FlemishBelgiumnl-NL
backlogEnglishAustraliaen-AU
backlogEnglishIndiaen-IN
backlogEnglishUnited Kingdomen-GB
backlogFrenchCanadafr-CA
backlogGreek, Modern (1453–)Greeceel-GR
backlogHebrewIsraelhe-IL
backlogHungarianHungaryhu-HU
backlogItalianItalyit-IT
backlogKoreanSouth Koreako-KR
backlogNorwegianNorwayno-NO
backlogPortugueseBrazilpt-BR
backlogSlovakSlovakiask-SK
backlogSpanish, CastilianSpaines-ES
backlogSwedishSwedensv-SE

​
What’s next

Similar to language, you can configure the currency that fiat amounts display in. See Fiat currency support for details.
AI coding reference — a compact summary of this page’s APIs, parameters, and patterns for use by AI coding assistants (following the llms.txt standard). Human readers can safely ignore this.llms.txt — Multi-language supportConfigure the language parameter to display Link in the user’s preferred language.Set in SDK initialization (all 5 platforms, same parameter name): language: 'system'Values: 'system' (auto-detects device/browser locale) | BCP 47 code (e.g. 'en-US', 'fr', 'fr-CA', 'zh-CN')Fallback chain: unknown region → language default (e.g. fr-FR for any French variant) → en-US. Unsupported language → en-US.Currently live: en-US, zh-CN, fi-FI, fr-FR, de-DE, hi-IN, id-ID, ja-JP, ms-MY, pl-PL, pt-PT, ru-RU, es-US, th-TH, tr-TR, uk-UA, uz-UZ, vi-VNBacklog (not yet live): ar-EG, zh-HK, zh-TW, cs-CZ, da-DK, nl-NL, en-AU, en-GB, en-IN, fr-CA, el-GR, he-IL, hu-HU, it-IT, ko-KR, no-NO, pt-BR, sk-SK, es-ES, sv-SENote: language and displayFiatCurrency are set in the same SDK initialization call. See Fiat currency support guide.