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.

  • Control panel. Adjust other localization details in the BigCommerce control panel.

Storefront language support

Each storefront can only support a single language. To display multiple languages, we recommend setting up a separate store for each language.

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

Some of the strings displayed on your storefront are not currently editable in BigCommerce. These are strings such as “This promotion cannot be applied with the selected currency.” BigCommerce will automatically render such strings in the shopper’s language as defined by the shopper’s browser language settings.

BigCommerce supports these uneditable strings in the following languages:

Currently BigCommerce only supports English for all stores. If you would like the additional languages turned on for your store, please reach out to our support team.

You can review these strings by downloading the language files we have made available in the portable object format. We recommend viewing these in a simple text editor or a text editor designed to handle PO files.

Localizing checkout

Localizing your theme’s checkout and order confirmation pages requires customizations within:

Checkout localization

Checkout localization is only available for Optimized One-Page Checkout.

Localizing control panel content

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

Transactional emails or gift certificates translation

The BigCommerce platform does not currently support translation of transactional emails or gift certificates into languages other than English, so instead we have provided a 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 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.

Localizing currency

You can configure each store’s default currency in the BigCommerce control panel. For details, see 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: Store SetupStore SettingsDate & Timezone. For details, see Date & Timezone Settings.

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 OrdersOrder Statuses. For instructions, see Customizing an Order Status Label.

Localizing the blog

Blog entries are managed through the BigCommerce control panel under Storefront ContentBlog. You can add blog content in any language you choose. For details, see Creating a Blog Post.

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 ContentWeb Pages, you must also enter their localized content in the control panel.

Managing transactional emails

BigCommerce does not currently provide native support for localizing transactional emails such as order confirmation or status updates. To fully localize a store into a language other than English, disable the sending of BigCommerce native emails.

To disable native emails, go to StorefrontEmail Templates. Uncheck each email type that you prefer to customize. If you would like to localize transactional emails, see our Partner Apps, such as CM Commerce, for more details.

Managing gift certificates

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


Related articles

Additional resources

Language files