# Localization

Localize your InStore implementation to support specific regions, languages, and currencies.

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](/instore/implement-instore/receipts/create-receipt-template.md#full-example).
5. [Set up the environment](/instore/use-the-instore-center/environment.md). 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](/instore/use-the-instore-center/location.md). Select the appropriate **Locale**, **Parameter Set**, and **Template Set**.
8. Ensure that any [reference list](/instore/use-the-instore-center/reference-lists.md) values include translated text for the new locale.
9. Set up demo data in your Project and test your changes.

## Configure your commercetools Project

Use the Merchant Center to localize your Project.

### Define international settings

- Localize supported currencies, languages, and countries in [Project Settings](/merchant-center/project-settings.md#manage-internationalization).

Take care to use the 5-character locale code (for example, `en-GB`) when specifying languages and countries.

### Update Categories

- Provide localized values for Category name, description, and any Custom Fields for [Categories](/merchant-center/categories.md).
- Remember to update any subcategories that exist for each category.

### Update Products

- Provide localized values for Product name, description, and other relevant fields for [Products](/merchant-center/products.md).
- For [Product Types and Attributes](/merchant-center/product-types.md), localize each Attribute such as size.
- If you use embedded prices, add a [Price](/merchant-center/prices.md#add-a-price) for each variant of the product in the Country's currency, specifying the Country.

### Add Tax Categories

- Add and configure region-specific Tax Categories and rates in [Project Settings > Taxes](/merchant-center/project-settings.md#add-a-tax-category).

### 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.

## Related pages

- [Area overview page with navigation](/instore.md)
- [Previous page: Inheritance](/instore/use-the-instore-center/inheritance.md)
- [Next page: Location](/instore/use-the-instore-center/location.md)
- [Search documentation and API specs](/search.md)