> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Turkish locale support for Paddle Checkout and subscription emails

Merhaba! Paddle now supports the Turkish locale for Paddle Checkout and subscription emails. Pass to Paddle.js when opening a checkout.

---

## What's new?

We added Turkish locale support to the Paddle platform, which means that [Paddle Checkout](https://developer.paddle.com/concepts/sell/self-serve-checkout.md) and subscription emails from Paddle Billing can be localized in Turkish.

As part of this change, we added `tr` as an allowed value for the `locale` parameter. You can pass this to [`Paddle.Checkout.open()`](https://developer.paddle.com/paddlejs/methods/paddle-checkout-open.md) or [`Paddle.Initialize()`](https://developer.paddle.com/paddlejs/methods/paddle-initialize.md) to set the language for opened checkouts to Turkish.

- **locale** (string): Language for the checkout. If omitted, the browser's default locale is used

## How it works

<!-- The Turkish government have changed the official name of the country to Türkiye, but we've used "Turkey" here. Paddle
     Checkout uses "Turkey" in English, and various style guides online still use it because it's the common name in
     English. We'll update if things change. See: https://en.wikipedia.org/wiki/Talk:Turkey/FAQ --->

Over 80 million people speak Turkish across the world, including Turkey, Northern Cyprus, and countries in the Caucasus region. It's a key language for selling into Central Eurasia.

The Paddle platform now supports the Turkish locale. This means that [Paddle Checkout](https://developer.paddle.com/concepts/sell/self-serve-checkout.md) can be localized in Turkish.

Paddle Checkout automatically detects the best language based on a customer's browser default and location. Customers making a purchase using [overlay checkout](https://developer.paddle.com/concepts/sell/overlay-checkout.md) can switch language using the drop-down at the bottom of the overlay. You can also [pass a `locale`](https://developer.paddle.com/build/checkout/set-up-checkout-default-settings#locale.md) when setting up Paddle.js or opening a checkout to set a locale yourself.

Where a customer completes checkout in Turkish, Paddle sends purchase and subscription-related emails in Turkish. The `locale` field against the [customer entity](https://developer.paddle.com/api-reference/customers/overview.md) created by Paddle Checkout is set to `tr`, meaning emails from Paddle are sent in Turkish.

## Next steps

This change is available now.

You can pass `tr` as a value for `locale` when [setting up or opening a checkout](https://developer.paddle.com/paddlejs/methods/paddle-initialize.md) to preview Paddle Checkout in Turkish, or use the drop-down at the bottom of overlay checkout to change language.

You can set `tr` as a value for `locale` when [creating](https://developer.paddle.com/api-reference/customers/create-customer.md) or [updating customers](https://developer.paddle.com/api-reference/customers/update-customer.md) using the Paddle API. Emails from Paddle to customers whose locale is `tr` are sent in Turkish.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `tr` | Enum value | added | locale | Turkish locale for Paddle.js checkout. |