Template Files
Templates Directory
Custom Templates
Customize Stencil Checkout
Handlebars Syntax and Helpers
Handlebars.js
Handlebars Helpers
Stencil Object Model
Stencil Objects

Localizing Stores

Localization Touchpoints Overview

You can run a BigCommerce store in any single language of your choice. If you want to support multiple languages, we recommend setting up a separate store for each language. To fully localize a store into a language/region other than U.S. English, you will need to customize three areas:

Storefront theme pages: Translate static strings. This requires adding translation files for your chosen non-English languages, via Stencil CLI.

Checkout: Localizing checkout requires modifications both to theme files (in Stencil CLI) and to settings in the BigCommerce control panel.

Outside your theme: Adjust other localization details via the BigCommerce control panel.

The following sections provide a linked summary of all the steps involved.


Translating Theme Files via Stencil CLI

The core of localizing a store is to translate content on your theme’s page templates into each language that you choose to support. 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.

For details on this process, see this section’s remaining pages, starting with Basis for Internationalization.


Localizing Checkout

Localizing your theme’s checkout and order confirmation pages requires specific steps in:

  • the corresponding templates
  • each of your JSON translation files
  • and in the BigCommerce control panel

Note: To localize your theme’s checkout and/or order confirmation page, you must first enable Optimized One-Page Checkout.

For details, please see the following pages:


Localizing Control Panel Content

The remaining localization options reside outside your theme and are accessible through the BigCommerce control panel:

Note: The BigCommerce platform does not currently support translation of Transactional Emails or Gift Certificates into languages other than English, so we have rather provided a management best practice for each.

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 want to localize a separate version of your catalog for each single-language store.

For an overview of populating the store catalog – including options for bulk-importing content that you can localize outside the BigCommerce platform – please see our support article on Adding and Managing Your Product Catalog.

Localizing Currency

Each store’s default currency is configured in the BigCommerce control panel. For details, please see our support article on Changing Your Default Currency.

Localizing Date Format

You can set the appropriate date format for your store’s language/region in the BigCommerce control panel (under Store Setup > Store Settings > Date & Timezone). For details, please see this support article.

Localizing Order Statuses

The order-status labels displayed on a BigCommerce storefront are configured outside your theme. You can translate each of these strings via the BigCommerce control panel’s Orders > Order Statuses option. For instructions, please see the Customizing an Order Status Label support topic.

Localizing the Blog

You manage blog entries through the BigCommerce control panel (under Storefront Content > Blog). You are free to add blog content in any language you choose. For details, please see this support article.

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 via the BigCommerce control panel (under Storefront Content > Web Pages), you must also enter their localized content via the control panel; for details, please see this support article.

Managing Transactional Emails

BigCommerce does not currently provide native support for localizing transactional emails. To fully localize a store into a language other than English, the simplest solution is to disable the sending of BigCommerce native emails. You can access this option from the BigCommerce control panel’s left nav in one of two locations (depending on your store’s control-panel version):

Storefront Design > My Themes > Design Options > More (drop-down list) > Emails Next, in the Enable column, uncheck the check box for each email type that you want to disable. (These toggles require no confirmation step.) For further details about managing BigCommerce transactional emails, please see this support article.

Managing Gift Certificates

The BigCommerce platform does not currently support translation of gift certificates into languages other than English. To fully localize your store, you can choose to disable gift certificates via the BigCommerce control panel.