Skip to main content

Documentation Portal

Global-e Checkout Language

By default, Global-e opens checkout in the shopper’s country language. If you'd like to customize or control the language shown in checkout, there are several ways to do it. This guide walks you through your options and what you need to do for each one.

Supported Languages

Global-e supports 32 languages out of the box, including:

  • English (US/UK)

  • French (FR/CA)

  • German

  • Spanish (Spain/Mexico)

  • Hebrew

  • Japanese

  • Chinese (Simplified/Traditional)

To see the full list, see Supported Languages.

Setting the Checkout Language from Your Website Code

You have two different options when setting the behavior of your Global-e Checkout language, setting the Checkout language from your website code (described in this section), or always using the language of the shopper's selected country (described in the next section).

If you want your Checkout page to open in a specific language based on your website settings (such as browser language or language selector), you can pass the language code from your site to Global-e.

To set the Checkout language from your website code
  1. Add the language code to location on your site that Global-e can read it from.

  2. Select one of the following language code storage formats:

    • A cookie

    • An HTML attribute, such as html lang="fr">

    • Local or session storage

    • The URL

    Note

    Work with your developer or frontend team to expose this language value where needed.

Make sure to let your Global-e integration engineer know where the language code is stored (such as cookie name or attribute name) so we can configure your Checkout page to read and use it automatically.

Tip

This is the flexible and preferred option if your website already has a language selector or multi-language structure.

Always Using the Shopper Country's Default Language

This method forces the Checkout page to load in the shopper country's default language independent of what browser or site language they use. You can do this by asking your Global-e contact to enable this configuration for your store. You can have this feature enabled without making any changes to your site.

For example, if a shopper selects Germany as a shipping country, the Checkout page will always display in German.

Setting the Checkout Language Directly via API

Global-e lets you pass the preferred language code in your getCheckoutCartInfo API response. You can do this by adding a "cultureCode" field to your API response and setting it to a supported language code (such as "it", "es-MX", or "ko-KR").