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

# Brazilian Portuguese locale support for customer-facing Paddle features

Olá! Paddle now supports Brazilian Portuguese as a locale for Paddle Checkout, the customer portal, customer emails, and Paddle Retain features. `pt-BR` is now an allowed value for `locale`.

---



## What's new?

We added Brazilian Portuguese locale support to the Paddle platform, which means that [Paddle Checkout](https://developer.paddle.com/concepts/sell/self-serve-checkout.md), the [customer portal](https://developer.paddle.com/concepts/customer-portal.md), customer emails, and [Paddle Retain](https://developer.paddle.com/concepts/retain/overview.md) features can be localized in Brazilian Portuguese.

As part of this change, we added `pt-BR` 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 locale for opened checkouts to Brazilian Portuguese.

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

## How it works

Portuguese is spoken by over 200 million people in Brazil, making it the most widely spoken language in South America. Paddle includes support for European Portuguese (`pt`), but Brazilian Portuguese has significant differences in vocabulary, grammar, and spelling.

With this update, the Paddle platform now supports Brazilian Portuguese. This means that [Paddle Checkout](https://developer.paddle.com/concepts/sell/self-serve-checkout.md), the [customer portal](https://developer.paddle.com/concepts/customer-portal.md), and [Paddle Retain](https://developer.paddle.com/concepts/retain/overview.md) features can be localized in Brazilian Portuguese. It's a key locale for selling into Latin America.

Paddle Checkout automatically detects the best language based on a customer's browser default language 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.

When a customer completes checkout in Brazilian Portuguese, Paddle sends purchase and subscription-related emails in Brazilian Portuguese. The `locale` field on the [customer entity](https://developer.paddle.com/api-reference/customers/overview.md) created by Paddle Checkout is set to `pt-BR`, meaning emails from Paddle and the customer portal are presented in Brazilian Portuguese.

## Examples

{% accordion %}
{% accordion-item title="Open a checkout with Brazilian Portuguese locale" %}

You can pass `pt-BR` as a value for `locale` when [initializing Paddle.js](https://developer.paddle.com/paddlejs/methods/paddle-initialize.md) or [opening a checkout](https://developer.paddle.com/paddlejs/methods/paddle-checkout-open.md).

{% callout type="info" %}
Language is detected automatically based on the customer's browser default and location. Pass `pt-BR` only when you want to override the default locale for a checkout to Brazilian Portuguese.
{% /callout %}

```javascript {% title="Paddle.Initialize()" %}
Paddle.Initialize({
  checkout: {
    settings: {
      locale: 'pt-BR'
    }
  }
});
```

{% /accordion-item %}
{% accordion-item title="Create a customer with Brazilian Portuguese locale" %}

You can set `pt-BR` 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 `pt-BR` are sent in Brazilian Portuguese. The customer portal is also localized in Brazilian Portuguese.

{% api-example method="POST" path="/customers" %}

```json {% title="Request" %}
{
  "name": "John Doe",
  "email": "john.doe@example.com",
  "locale": "pt-BR"
}
```

{% /api-example %}

{% /accordion-item %}
{% /accordion %}

## Next steps

This change is live in Paddle.js now.

You don't need to do anything to get the latest version of Paddle.js — we serve the latest version automatically.

You can preview Paddle Checkout in Brazilian Portuguese by passing `pt-BR` as a value for `locale` when [initializing Paddle.js](https://developer.paddle.com/paddlejs/methods/paddle-initialize.md) or [opening a checkout](https://developer.paddle.com/paddlejs/methods/paddle-checkout-open.md). You can preview the customer portal and customer emails in Brazilian Portuguese by setting `pt-BR` 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.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `pt-BR` | Enum value | added | locale | Brazilian Portuguese locale for Paddle.js checkout. |