Localizing Stores
A BigCommerce storefront can be customized to display in any one language of your choice. To fully localize a store for a language or region, you will need to customize three areas:
-
Storefront theme pages. Translate static strings by adding translation files for your chosen languages via Stencil CLI.
-
Checkout. Localize checkout by modifying theme files in Stencil CLI and settings in the BigCommerce control panel.
-
Storefront content. Adjust other localization details in the BigCommerce control panel.
Localizing theme files
Localize your theme by adding translation files via Stencil CLI.
Translating theme files by Stencil CLI
The bulk of localizing a store is translating content on your theme's page templates. You will need to abstract these templates' literal text strings into {{lang}}
variables, then provide per-language JSON files that define these variables in corresponding key/value pairs.
Multiple language strings by BigCommerce
Currently, you cannot edit strings such as "This promotion cannot be applied with the selected currency" in BigCommerce. The language settings for these strings are not defined by the shopper's browser language settings. Rather, you select your storefront's display language using the default language setting found in the control panel's Store Profile (opens in a new tab). This language setting determines the language of your storefront content.
BigCommerce's Cornerstone Stencil theme supports these uneditable strings in the following languages:
- Danish
- Dutch
- English
- French
- German
- Italian
- Japanese
- Norwegian
- Polish
- Portuguese
- Portuguese (Brazil)
- Spanish (Argentina)
- Spanish (Chile)
- Spanish (Columbia)
- Spanish (Latin America & Caribbean)
- Spanish (Mexico)
- Spanish (Peru)
- Spanish (Spain)
- Swedish
Localizing checkout
Localizing your theme's checkout and order confirmation pages requires customizations within the default checkout page and the order confirmation HTML file. See Multi-language setup for details.
Checkout localization
Checkout localization is only available for Optimized One-Page Checkout.
Localizing your storefront content
Localize the control panel and options outside your theme by accessing the Default Language setting, found in the control panel's Store Profile (opens in a new tab). The Store Profile allows localization of the following items:
- Product catalog
- Currency
- Date format
- Order statuses
- Blog
- Static web pages
- Transactional emails
- Gift certificates
- System messages
Localizing the product catalog
You must localize the store's product catalog separately from its theme. Each entry within a catalog can be set up in only one language, so you will need to localize a separate version of your catalog for each single-language store.
For an overview of how to populate the store catalog, including options for bulk-importing content that you can localize outside the BigCommerce platform, see Adding Products (opens in a new tab).
Localizing currency
You can configure each store's default currency in the BigCommerce control panel. For details, see Changing Your Default Currency (opens in a new tab).
Localizing date format
You can set the appropriate date format for your store's language/region in the BigCommerce control panel: Settings > General > Date & Timezone (opens in a new tab). For details, see Date & Timezone Settings (opens in a new tab).
Localizing order statuses
You can configure the order-status
labels displayed on a BigCommerce storefront outside your theme. You can translate each of these strings in the BigCommerce control panel under Orders > Order Statuses (opens in a new tab). For instructions, see Customizing an Order Status Label (opens in a new tab).
Localizing the blog
Blog entries are managed through the BigCommerce control panel under Storefront > Blog (opens in a new tab). You can add blog content in any language you choose. For details, see Creating a Blog Post (opens in a new tab).
Localizing static web pages
If you create static pages as Stencil custom templates, you can localize their content just like other theme pages' content. However, if you create custom pages in the BigCommerce control panel under Storefront > Web Pages, (if MSF is active on your store go to Channel Manager > Channels > Storefronts > Quick links > Web Pages), you must also enter their localized content in the control panel.
Managing transactional emails
To fully localize a store into a language other than English, disable the sending of BigCommerce native emails. To disable native emails, go to Marketing > Transactional Emails (opens in a new tab). Uncheck each email type that you prefer to customize.
You can localize transactional emails by using compatible third-party apps such as CM Commerce (opens in a new tab).
Managing gift certificates
To fully localize your store, disable gift certificates in the BigCommerce control panel.
Managing system messages
You can localize a store's payment and checkout error messages via checkout-js in the BigCommerce control panel. For a list of error messages and supported languages, see Verbose Error Messages at Checkout (opens in a new tab).
To customize payment and checkout messages, define these variables in the theme language files. For details, see Multi-language setup.
Resources
Related articles
- Translation Keys
- Restyle Optimized One-Page Checkout
- Multi-Language Checkout
- Adding Products (Help Center) (opens in a new tab)
- Changing Your Default Currency (Help Center) (opens in a new tab)
Additional resources
- Cornerstone - checkout.html (GitHub) (opens in a new tab)
- Cornerstone - order-confirmation.html (GitHub) (opens in a new tab)
- Cornerstone - JSON translation file (GitHub) (opens in a new tab)