Skip to main content

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

🌐 Web SDK example

const connection = createLink({
  ...
  language: 'system',
  ...
})

🍏 iOS Native SDK example

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

🤖 Android Native SDK example

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

ReactNative SDK example

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

Flutter SDK example

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

StatusLanguageRegionLocale code
liveEnglishUnited States global defaulten-US
liveSpanishUnited States es defaultes-US
liveRussianRussiaru-RU
liveFrenchFrance fr defaultfr-FR
liveChinese/Mandarin (Simplified)China zh defaultzh-CN
liveTurkishTurkeytr-TR
livePolishPolandpl-PL
liveJapaneseJapanja-JP
liveGermanGermanyde-DE
liveFinnishFinlandfi-FI
liveHindiIndiahi-IN
liveIndonesianIndonesiaid-ID
liveMalayMalaysiams-MS
livePortuguesePortugal pt defaultpt-PT
liveThaiThailandth-TH
liveUkrainianUkraineuk-UK
liveUzbekUzbekistanuz-UZ
liveVietnameseVietnamvi-VN
livesystemsystem
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