Brazilian Portuguese locale support for customer-facing Paddle features

What's new?

We added Brazilian Portuguese locale support to the Paddle platform, which means that Paddle Checkout, the customer portal, customer emails, and Paddle Retain 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() or Paddle.Initialize() to set the locale for opened checkouts to Brazilian Portuguese.

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, the customer portal, and Paddle Retain 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 can switch language using the drop-down at the bottom of the overlay. You can also pass a locale 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 created by Paddle Checkout is set to pt-BR, meaning emails from Paddle and the customer portal are presented in Brazilian Portuguese.

Examples

Paddle.Initialize({
  checkout: {
    settings: {
      locale: 'pt-BR'
    }
  }
});

{
  "name": "John Doe",
  "email": "john.doe@example.com",
  "locale": "pt-BR"
}

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 or opening a checkout. You can preview the customer portal and customer emails in Brazilian Portuguese by setting pt-BR as a value for locale when creating or updating customers using the Paddle API.