This guide explains how to configure Mesh Link to support multiple languages, allowing you to provide a localized experience for your users.

​

Understanding Language Configuration with linkLanguage

The linkLanguage parameter, which you set during Mesh Link initialization, is the key to displaying Link in your user’s preferred language. This parameter allows you to:

• Automatically match the user’s device/browser language, or
• Specify a particular language.

​

Key Parameter: linkLanguage

You’ll use the linkLanguage parameter when initializing Mesh Link via your SDK (Web, iOS, Android, or React Native).

​

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).
• Coming soon: 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

​

Initialize Link with linkLanguage

When you initialize Link in your application, use the linkLanguage parameter to specify the desired language behavior.

​

Web SDK

const connection = createLink({
        ...
        language: 'en-US'
        ...
      })

​

Android SDK

val configuration = LinkConfiguration(
    token = "linkToken",
    language = "en-US")

​

iOS SDK

let settings = LinkSettings(language: "en-US")
let configuration = LinkConfiguration(
    linkToken: linkToken,
    settings: settings,
    ...
    )

​

React native SDK

<LinkConnect settings={{language: 'en-US'}} ... />

​

Testing 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 notify your Mesh support person if you see any words or phrases that you believe are incorrectly translated if you see any layout issues (for example with right-to-left languages or character-based languages).

​

Currently supported languages