---
title: Localization
description: >-
  Configure locale settings for Shop Pay Wallet API to support multiple
  languages.
api_name: commerce-components
source_url:
  html: 'https://shopify.dev/docs/api/commerce-components/pay/localization'
  md: 'https://shopify.dev/docs/api/commerce-components/pay/localization.md'
---

# Localization

**Note:**

This API is **only available to select merchants and partners** using third-party checkout solutions. For more information, contact [our enterprise sales team](https://www.shopify.com/solutions/shop-pay/enterprise#contact-sales).

Localization is a crucial aspect of providing a seamless shopping experience for customers around the globe. The Shop Pay Wallet API supports localization to ensure that customers can interact with the checkout process in their preferred language.

***

## Setting the Locale

To set the locale, include the `locale` parameter when configuring the Shop Pay Payment Request. The `locale` parameter expects a valid ISO language code, with some locales followed by an ISO country code. See the [Supported Locales List](#supported-locales-list) section for the full list.

```javascript
window.ShopPay.PaymentRequest.configure({
shopId: 1,
clientId: "[REPLACE-ME.myshopify.com]",
locale: 'fr' // Example: Set locale to French
});
```

**Note:**

If no locale is provided or if the provided locale is invalid, the default locale will be set to English (`en`).

***

## Supported Locales List

The following locales are supported by the Shop Pay Wallet API:

| **Locale Code** | **Language** |
| - | - |
| `cs` | Czech |
| `da` | Danish |
| `de` | German |
| `en` | English (Default) |
| `es` | Spanish |
| `fi` | Finnish |
| `fr` | French |
| `hi` | Hindi |
| `it` | Italian |
| `ja` | Japanese |
| `ko` | Korean |
| `ms` | Malay |
| `nb` | Norwegian Bokmål |
| `nl` | Dutch |
| `pl` | Polish |
| `pt-BR` | Portuguese - Brazil |
| `pt-PT` | Portuguese - Portugal |
| `sv` | Swedish |
| `th` | Thai |
| `tr` | Turkish |
| `zh-CN` | Chinese - Simplified |
| `zh-TW` | Chinese - Traditional |

***