Displaying Your Content in Multiple Languages
To deliver a seamless and personalized shopping experience for your customers, Shopper App supports the localization of your store's content into target languages, enabling optimized operations across multiple markets.
Multi-language Feature Overview
Shopper App currently supports six languages: English, Spanish, French, German, Italian, and Japanese. These languages are also listed in order of priority.
The default language for Shopper App is determined by the settings in Settings > Language > Supported Languages of your admin panel. The rules are as follows:
- If your store's default language is one of the supported languages, that language will be set as the default language for Shopper App.
- If your store's default language is not supported by Shopper App, but some of your other enabled languages are, the app will default to the highest-priority supported language. For example, if your store's default language is Portuguese (which is not supported), the system will recognize that you have enabled five supported languages and set English as the default, as it holds the highest priority.
- If none of the supported languages is on your list, Shopper App will default to English.
This language display logic applies to all available settings in Shopper App, including the app editor and other configurations. See the "Configurations That Support Multi-Language" section for the full scope.
Language Selection on Customer Devices
On the customer side, the rules follow a similar logic to the previous section, with additional consideration for the market's language settings. Here's how the system determines the default language for a customer's device:
- Based on the customer's IP location, Shopper App identifies the languages supported in the corresponding market. It then selects the languages it supports (English, Spanish, French, German, Italian, and Japanese) from this range to create the base language set:
- If the customer's device language is in the base language set, that language will be displayed.
- If the customer's device language is not in the base language set, the app checks the merchant's default language for the market:
- If the market's default language is in the base language set, the app will display content in the market's default language.
- If the market's default language is not in the base language set, the app will display content in the first available language from the following priority order: English, Spanish, French, German, Italian, and Japanese.
- If the merchant's configured language list for the customer's country does not include any of the app's supported languages, the app will default to displaying content in English.
Configurations That Support Multi-Language
The following table lists the modules, pages, and places where the multi-language feature applies:
Module | Configurable Pages | Configurable Content |
App Design | Homepage | The images, title, and text of components |
Collection page | The image and title of collections | |
Product list age | The title of announcements | |
Product details page | The title of components | |
Shopping bag (cart) | The title of announcements and the Product Recommendation component | |
My Account | The title of components | |
Custom page | The images, title, and text of components | |
Help & Information | The title of components | |
Terms & Conditions | The title of components | |
App Settings | Custom message | All custom messages |
Push Notification | Manual notifications | The title and content of notifications |
Configuring Multi-language Display
Let's use the homepage design as an example to demonstrate how to set up a multi-language display in your Shopper App. Open the Shopper App editor and select Home page from the dropdown menu at the top.
Check or Change the Default Language
- The default language is displayed to the right of the page selector.
- To change the default language, go to Settings > Language > Supported Languages and update it there.
Set Multi-Language Content for Components
You can configure multi-language content for individual components. Components that support multiple languages are marked with a translation icon . Let's take a Collections component as an example:
- Images:
- Replace images with localized versions for each supported language.
- Click Upload an image to upload images for the corresponding languages as needed.
- Text:
- The collection title and button text support multi-language display.
- Enter text in the corresponding language fields to localize the content.
This process applies to push notifications and custom messages as well.
Note: You must complete all required fields in the default language before adding translations. Other languages are optional and can be filled in as needed. |