{"title":"Language localization","slug":"language-localization","url":"https://support.storeconnect.com/articles/language-localization","url_markdown":"https://support.storeconnect.com/articles/language-localization.md","subtitle":null,"summary":"Set up a multilingual storefront by creating theme locales, defining translation keys, and assigning a locale to your store. Walk-through example translates login flow labels into Latin American Spanish.","type":"Help_Documentation","video_url":"","keywords":"language localization, multilingual storefront, theme locales, locale translation, translation keys, language settings, store locale, spanish translation, regional language, language configuration, multilingual store setup, locale configuration","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"The ability to cater to diverse audiences in a variety of geographic locations is essential for the success of the majority of online business models. StoreConnect, built entirely on Salesforce, offers robust theming and templating capabilities and provides an ideal platform for creating multilingual and multi-regional online stores.\n\nThis guide will walk you through the process of setting up a simple example language translation (Latin American Spanish) to pinpoint a regional market, leveraging the power of StoreConnect and Salesforce.\n\nTranslating content into a regional language is an important step in this process. This guide will use the “Beauty Demo Store”, which is installed with a StoreConnect Trial installation as explained [here](https://getstoreconnect.com/preview/content_article/a1A2u000007EsitEAC). We will configure the “Log In” and “My Account” labels and the login form to display in South American Spanish as seen below:\n\n![Image](https://res.cloudinary.com/hzkr6fi81/image/upload/v1702662189/media/Screenshot_2023-12-15_at_10.41.48_AM.png)\n\n### **1\\. Install StoreConnect**\n\nTo host this on a website, we need to get StoreConnect installed, as described [here.](https://getstoreconnect.com/preview/content_article/a1A2u000007EsitEAC)\n\nOnce this is complete, you should have a StoreConnect Store and Site that is accessible online.\n\n### **2\\. Ensure you have a StoreConnect store set up and the store has a theme defined**\n\nThemes in StoreConnect are collections of display and logic elements applied to a site. They define how content is presented and interacted with, offering a singular yet adaptable design across different pages. Once StoreConnect is installed, three Primary objects/values work in conjunction to enable content to be viewed in different languages:\n\n1.  ‘Theme’ Configuration\n2.  ‘Language Locale’ Configuration\n3.  ‘Language Locale Translation’ Configuration\n\n*\\*Please insure that the user handling these configurations has access to these Objects/Records as described in the [Install StoreConnect](https://getstoreconnect.com/preview/content_article/a1A2u000007EsitEAC) guide.*\n\nLocalization is typically done in the setup phase of a store/sub-store.\n\n1.  Click on the “Store” tab and select a store as a target for the language desired\n2.  Once the store is selected, click on the value shown in the “Theme” field value. *\\*If this field does not contain a value, select a theme (or optionally create one)*\n3.  Select a value in the “Locale” drop-down. This will be the language visible on the public site. In this example, we will choose `Spanish (Mexican)`\n\n![Image](https://res.cloudinary.com/hzkr6fi81/image/upload/v1706906852/media/select-locale-highlighted.png)\n\n### **3\\. Implement theme locales for language variants**\n\nEach theme can have multiple locales, which enable the presentation of a storefront in a given language. To set up a given language, define a locale for your theme:\n\n1.  Click on the `Related List` tab of the theme\n2.  Navigate to the `Locales` section\n3.  Click the `New` button to define a new Locale to define the language desired\n4.  Give the `Theme Locale Name` a meaningful name (in this guide, it will be ‘Spanish (Mexico)’ and select the language this Locale will display by selecting the language in the `Locale` drop-down list. Likewise, we will select ‘Spanish (Mexico)’ from the available values in the picklist\n5.  Enable the `Active` value to make the language available to display in the current storefront. In this example we will activate the “Spanish (Mexican)” Theme Locale\n\n![Image](https://res.cloudinary.com/hzkr6fi81/image/upload/v1706907060/media/locale-activate-highlight.png)\n\n### **4\\. Define theme locale translations and key values**\n\nTheme locales have translations that correspond to specific key values found in the front-end presentation. These keys are linked to Salesforce records and fields, allowing for dynamic content display, based on the selected language of the theme. *Replacing an entire list of terms on an interface is most quickly achieved by a bulk upload in a CSV file via DataLoader.*\n\nFor the purposes of this guide, we will focus on replacing the login flow with a few selected terms for their respective object keys:\n\n1.  ‘Log in’ (Link) - `header.dropdowns.account.login`\n2.  ‘Sign in to your account’ - `auth.login.heading`\n3.  ‘Username’ - `auth.login.form.username`\n4.  ‘Password’ - `auth.login.form.password`\n5.  ‘Log in’ (Button Label) - `auth.login.form.submit`\n\nWe will add the display of these values in Latin American Spanish with the following Spanish terms:\n\n1.  ‘Mi Cuenta’ (Link) - `header.dropdowns.account.login`\n2.  ‘Ingresa tu usuario y contraseña.’ - `auth.login.heading`\n3.  ‘Usuario’ - `auth.login.form.username`\n4.  ‘Contraseña’ - `auth.login.form.password`\n5.  ‘Entrar’ (Button Label) - `auth.login.form.submit`\n\n### **5\\. Add theme locale translations and key values**\n\nTo add these specific value keys, we will do the following:\n\n1.  Click on the `Related Lists` tab of a the Language Locale\n2.  Select ‘Spanish (Mexico)’\n3.  Select the `Related` tab\n4.  Select the `New` button on the right\n5.  Add the key value (eg. header.dropdowns.account.login) with the string value to present when that key is found in the interface (eg. ‘Mi Cuenta’)\n6.  Click `Save`\n7.  Repeat this for the other terms in the list above\n\n![Image](https://res.cloudinary.com/hzkr6fi81/image/upload/v1702662032/media/Screenshot_2023-12-15_at_10.36.31_AM.png)\n\n:::note\nTerms that include a number, such as a cart item count, need more than one wording per language. Rather than creating a separate key for each, add a single pluralized key and let the storefront select the correct form. See [managing singular and plural numeric translations](translation-pluralization).\n:::\n\n### **6\\. Test your language implementation:**\n\n1.  Ensure that the “Locale” field for the store is set to ‘Spanish (Mexico)’ (See Step 2 above)\n2.  Go to your public storefront\n3.  Check the location of the ‘Log in’ link on your storefront. This guide is using the ‘Clean Theme’ which is installed with StoreConnect Trial installs. This link appears in the upper right and should now display as ‘Mi Cuenta’\n4.  Click the ‘Mi Cuenta’ link\n5.  Check the log in form. This should now present the Spanish terms we have defined\n\n![Image](https://res.cloudinary.com/hzkr6fi81/image/upload/v1707261317/media/login-form-translated-highlighted_1.png)"}