Localization

Specify a locale and currency for an environment

You can localize your InStore implementation for a specific region. InStore handles several mainstream currencies, only one of which operates in a given environment.

InStore supports multiple country-specific languages for which InStore provides language bundles and translated receipt templates as a starting point for customization. Through the InStore Tenants API, retailers can modify any language bundle to reflect company-specific word choices.

Before starting

• Verify that InStore supports the currency you plan to use.
• Verify that the tax interface you will use supports the locale you are adding.
• Verify that the in-person payment provider (such as Stripe or Adyen) supports the country and is authorized to operate there.

Setup in the InStore Center

In the InStore Center, do the following:

1. Access the Parameters menu option.
2. Create a parameter set or edit an existing set so that the Supported Languages parameter is included.
3. Edit the Supported Languages parameter values to include the locale you are adding. Save changes.
4. Access the Receipt Templates menu option.
5. From the provided receipt templates in en-US, create a customized, translated receipt template set.
6. Set up the environment, taking care to select the correct currency before activating the environment. Assign the new parameter set and receipt template set to the environment.
7. Populate the Tax ID field for the environment.
8. Add a location, taking care to select the appropriate Locale, Parameter Set, and Template Set.
9. Verify that any reference list values you have added include translated text for the new locale.
10. Set up demo data in commercetools and test your changes.

Set up your commercetools Project

To configure your commercetools Composable Commerce Project, do the following in the Merchant Center:

Define international settings

1. From the Merchant Center main menu, select Settings > Project Settings.
2. On the International tab, define the supported currency, language, and country.

Update Categories

1. From the Merchant Center main menu, select Categories.

2. For each Category, provide localized values for the following fields:

   • Category name
   • Category description
   • Any Custom Fields that may be present.

Update Products

1. From the Merchant Center main menu, select Products.

2. For each Product, provide localized values for the following fields:

   • Product name
   • Product description
   • Brand
   • Receipt Text
   • Any other relevant fields

3. For each Product variant, provide localized values for each variant attribute (for example, colors, sizes, currency-specific prices, and country).

Update Tax Categories

1. From the Merchant Center main menu, select Settings > Project Settings.
2. Select the Taxes tab.
3. For each applicable Tax Category, select Add rate.
4. Provide the Name, Country, and Rate. Also indicate whether tax, such as VAT, is included in the price of the item.