Skip to main content

Documentation Portal

Language

Language Selector

The checkout process supports a multilingual experience to cater to global audiences. This functionality includes a language selector and the ability to preselect and display languages, providing a seamless and localized experience for users.

The Language Selector enables customers to choose their preferred language from a drop-down menu. The selector ensures clarity and ease of navigation for users preferring different languages and accommodates diverse customer bases with language preferences tailored by region.

Once a language is selected all the text on the page automatically updates to display in the chosen language.

Localized language options help users navigate the checkout process easily. Shopping in a local language reduces confusion and increases the likelihood of completing purchases. The ability to choose a local language appeals to a wider audience by catering to non-English speaking customers. Integration is seamless, and the language selector works dynamically without requiring users to restart their checkout journey after a language change.

The checkout can be configured to automatically refresh and display product details in the newly selected language once selected. The language selector feature ensures consistency in language presentation across product descriptions and checkout elements.

Using the Language Selector

The Language Selector can display at the bottom or top of the page. When at the top of the page, the selector provides easy access for users to switch languages before proceeding. If the selector is at the bottom it helps users to change the language after navigation through checkout sections.

language_selector_at_the_top.png

To select a language, the customer clicks on the Language Selector to display the list of available languages and then clicks on a language. Once selected, all text elements on the page are immediately updated to reflect the chosen language.

language_selector.png

Available Languages

Pages can be translated into any of the following 36 languages, which are presentation-only and not input-based:

  • Arabic

  • Chinese (Simplified)

  • Chinese (Traditional)

  • Chinese (Taiwan)

  • Croatian

  • Czech

  • Danish

  • Dutch

  • English UK

  • English US

  • Finnish

  • French

  • French (Canadian)

  • German

  • Greek

  • Hebrew

  • Hindi

  • Indonesian

  • Italian

  • Japanese

  • Korean

  • Malay

  • Norwegian

  • Polish

  • Portuguese

  • Romanian

  • Russian

  • Slovak

  • Spanish

  • Spanish (Latina America)

  • Swedish

  • Thai

  • Turkish

  • Urdu

  • Vietnamese

Text translations are available for all supported languages. Input fields (e.g., names, addresses) are not automatically translated or localized.

Preselecting a Language

Merchants can configure the checkout page to open in a preselected language using the PreferredCultureCode received in the SendCart request. The preselected language ensures a more localized and tailored experience from the outset.

Multi-Language Support

The checkout process supports multi-language input to cater to a diverse global audience. This capability allows merchants to configure acceptable input languages based on their customers' regional and linguistic needs, ensuring a seamless and localized user experience.

Customers can input information in their preferred language, increasing satisfaction and reducing entry errors. The checkout supports a wide range of languages to accommodate global merchants and shoppers. Merchants can tailor the input languages based on regions, ensuring compliance with local preferences and regulations.

  • Regional Support: A merchant operating in Europe can enable input for German, French, and Italian, catering to their multilingual customer base.

  • Localized Marketing: Merchants in the Middle East can support Arabic and Farsi for a localized and culturally relevant checkout experience.

  • Global Operations: International merchants can enable a wide range of languages to support their global customer base.

While most languages are supported, some character sets may require additional configurations or backend validation. Special characters may be automatically converted to Latin equivalents where necessary for compatibility with carriers and payment systems.

How it Works

  • Merchant Configuration: Merchants can define allowed languages per country or region via the checkout settings.

  • Dynamic Input Validation: The system dynamically validates input fields based on the configured languages, ensuring compliance and accuracy

Global-e supports configuring allowed input languages for each merchant country. This feature ensures that inputs are restricted to specific languages based on the merchant's location.

Administrators can define the allowed languages for input on a per-country basis. Only the specified languages are accepted for inputs in the corresponding merchant country.

English is always allowed by default and does not need to be explicitly specified in the configuration files.