Localization

InStore enables you to customize your environment for different regions by specifying supported currencies, languages, and country-specific settings. Each environment supports only one currency, which cannot be changed after environment activation. InStore supports multiple languages, and you can update language bundles using the InStore Tenants API to reflect company-specific terminology. The Locale setting controls both language and country values and can be updated for an environment as needed.

Prerequisites

Before configuring localization, ensure the following:

• The currency you plan to use is supported by InStore.
• The tax interface supports the locale you are adding.
• The in-person payment provider (for example, Stripe or Adyen) is authorized to operate in the target country.

Configure localization in the InStore Center

To set up localization, do the following:

1. In the InStore Center, select Parameters.
2. Create a new parameter set or edit an existing set to match local business practices.
3. Select the Receipt Templates menu option.
4. Use the provided receipt templates (en-US) to create a customized and translated receipt template set.
5. Set up the environment. Select the correct currency before activating the environment. Assign the new parameter set and receipt template set to the environment.
6. Enter the Tax ID for the environment.
7. Add a location. Select the appropriate Locale, Parameter Set, and Template Set.
8. Ensure that any reference list values include translated text for the new locale.
9. Set up demo data in Composable Commerce and test your changes.

Configure your commercetools Project

Use the Merchant Center to localize your commercetools Composable Commerce Project.

Define international settings

• Localize supported currencies, languages, and countries in Project Settings.

Update Categories

• Provide localized values for Category name, description, and any Custom Fields for Categories.

Localize Products

Update Products

• Provide localized values for Product name, description, and other relevant fields for Products.
• For Product Types and Attributes, localize each Attribute such as color and size.

Add Tax Categories

• Add and configure region-specific Tax Categories and rates in Project Settings > Taxes.

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.