> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Embed localization

## Overview

Embed can be configured to use a different language using the `locale` property.
By default, this is set to `en` (English). Embed accepts a
[ISO 639-1 Language Code](https://www.iso.org/iso-639-language-codes.html) (for example
`en` or `fr`) and an optional
[ISO 3166 Country Code](https://www.iso.org/iso-3166-country-codes.html) (for example
`AU` or `GB`). The country code allows a localized version of the
language to be provided based on a specific country, for example `fr-CA` would represent Canadian
French.

## Usage

The locale can be set to any of the [supported Locales](#locales). The
locale property falls back to English if a locale is not provided, is
incorrect or not supported.

<Warning>
  Embed currently does not automatically detect the buyer's locale. The locale
  is always set to `en` when not provided.
</Warning>

<CodeGroup>
  ```tsx React theme={"system"}
  <Embed currency="AUD" amount="2300" locale="en-AU" />
  ```

  ```js CDN theme={"system"}
  setup({
    ...,
    amount: 1299,
    country='AU'
    currency: "AUD",
    locale: 'en-AU'
  });
  />
  ```
</CodeGroup>

## Locales

The following locales are currently supported.

| Locale Name          | Language Code (ISO 639-1) | Country Code (ISO 3166) | Locale  |
| -------------------- | ------------------------- | ----------------------- | ------- |
| American English     | `en`                      | `US`                    | `en-US` |
| British English      | `en`                      | `GB`                    | `en-GB` |
| Brazilian Portuguese | `pt`                      | `BR`                    | `pt-BR` |
| Croatian             | `hr`                      |                         | `hr`    |
| Dutch                | `nl`                      |                         | `nl`    |
| French               | `fr`                      |                         | `fr`    |
| German               | `de`                      |                         | `de`    |
| Indonesian           | `id`                      |                         | `id`    |
| Italian              | `it`                      |                         | `it`    |
| Malay                | `ms`                      |                         | `ms`    |
| Portuguese           | `pt`                      |                         | `pt`    |
| Romanian             | `ro`                      |                         | `ro`    |
| Spanish              | `es`                      |                         | `es`    |
| Thai                 | `th`                      |                         | `th`    |
