The eCommerce Shop, like all websites, features static and dynamic content. Although, most elements that can be customized using the appropriate eCommerce Admin page, some elements are “hard-coded” into the HTML and are therefore static.

For example: In the eCommerce Shop, “Shop All Products” is static, but a product’s title is pulled in from Corporate Office > Inventory Items page configuration. Should you want to change a product category, you can simply edit the configuration in the Corporate Office.
But, what if you want to change something that is static content? The Localization page gives you this power to change any static content “string”. You can use the page to find all instances of the static content string and change them to whatever you want.

With this system you can manage all of your translations easily and have your shop localize dynamically. Many of the content customizations you will be doing throughout this guide for your eCommerce Shop will be modifying the static content to be what you want.

What We’ll Cover

• Finding the Page
• Editing String Keys
• Adding a String
• Exporting Translations
• Importing Translations

---

---

Finding the Page

In eCommerce Admin, navigate to: Content Management > Localization.

[CLIENTID].retailadmin.directscale.com/#/Localization

---

---

Editing String Keys

Strings are defined in the HTML translate attribute, such as <p translate="string_name"></p>. You can use the developer tools for your browser to find the string in the HTML code (e.g., In Chrome, right-click the static text and select Inspect.)

1. In the Localization page, search for either the string name or the text you want to change.

   The search results appear below the search bar. You can filter them based on type.

2. Click the Edit icon for the string you want to change.

   The Edit String pop-up window opens.

   

3. In the Text Value field, change the text to suit your needs.

4. If you have other languages configured, click each language and enter the translations.

5. Click SAVE.

For changes to be visible now, click CLEAR CACHE.

Then, if you have the eCommerce Shop open in a different tab, refresh the page to see your changes.

Note: some string changes can take awhile to take effect. Clearing your browser cache can be effective or checking back later until the system’s cache clears automatically.

---

---

Adding a String

1. Click the + ADD NEW button to open the New String pop-up window.

   

2. In the pop-up, click the Select Application dropdown and select Retail.

   Currently the only option is Retail.

3. Enter the string name in the Key field.

4. In the Text Value field, enter the text that will display in the eCommerce Shop.

5. Click SAVE.

For changes to be visible now, click CLEAR CACHE.

Then, if you have the eCommerce Shop open in a different tab, refresh the page to see your changes.

Note: some string changes can take awhile to take effect. Clearing your browser cache can be effective or checking back later until the system’s cache clears automatically.

---

---

Exporting Translations

This page features the ability to export a CSV file (that can be opened in any spreadsheet program, such as Excel or Google Sheets) and modify the translations in bulk. Translations are displayed in the eCommerce Shop based on the value entered in the string or in the exported CSV. If there is no value entered for the market/language, it will default to the next available value.

1. Click the IMPORT/EXPORT button and select Export Translations.

   The Export Translations pop-up window opens.

   

2. In the Language dropdown, select the language to be translated.

   If you export English, only enter English values. If you select Spanish, enter Spanish values.

3. Expand the Advanced options section.

   Two checkboxes are revealed:

   • Include market-specific translations – Useful if there are multiple markets for a language that need unique translations (Mexico – Spanish, Spain – Spanish, Puerto Rico – Spanish).
   • Only include missing translations – Instead of exporting the entire eCommerce Shop, this will only export the text that is missing translations for the selected language.

   Check the necessary box(es).

4. Click the EXPORT button.

   This will download the workable CSV file.

5. Enter the translations in the CSV file.

   

   Important: The English default column shouldn’t be changed in the translation process. If changed, the system will not recognize either the English value or the translation provided, and users will see an error in the eCommerce Shop where ever the text appears.

6. Save the file.

   The file is ready to be imported back into the system.

---

---

Importing Translations

Importing translations allows you to upload all of the translations that were entered into the export document.

1. Click the IMPORT/EXPORT button and select Import Translations.

   The Translations pop-up window opens.

   

2. Click the IMPORT button.

   Your computer’s file finder window opens.

3. Select the completed translations spreadsheet from your computer.

   

   The translations will show in the eCommerce Shop once the cache is recycled.

   This can take up to 30 minutes.

4. Click IMPORT ANOTHER FILE to repeat the process, If necessary.