Troubleshoot translation issues

Many common translation issues have workarounds.

This section applies to both OSF and Storefront Classic. This section applies to Open Storefront Framework (OSF) and Storefront Classic.

This list describes workarounds for common translation issues.

  • If your store supports additional languages but you do not translate all the translatable shopper-visible properties, the untranslated strings will appear in the store’s default language. This can result in multiple languages appearing on the same page. For example, if you translate product names but not descriptions, the name and description will appear in different languages on the product details page.
  • When you select a default language for your store, select a language that specifies a neutral locale, not one that specifies a region-specific local. For example, select English not English (United States) or English (Canada). To support region-specific variants of the default language on your store, add them to the Additional Store Languages list. See Select additional languagesfor more information.

Note: In this release, there are no neutral-locale options for Chinese or Portuguese. You must select either Chinese (Simplified) or Chinese (Traditional) for Chinese and Portuguese (Portugal) or Portuguese (Brazil) for Portuguese.