# Available languages

This article details the languages supported in Kustom Checkout (KCO) and how they function.

## Background

KCO supports a limited set of locales per country to maintain high-quality localized descriptions. Locale affects language only and doesn't impact purchase country or currency. For broader information on language localization, see [https://en.wikipedia.org/wiki/Language_localisation](https://en.wikipedia.org/wiki/Language_localisation).

## Table of available languages and locales

| Language | Locale | Description |
|  --- | --- | --- |
| Danish | da | Default |
| Dutch | nl | Default |
| English | enen-ATen-DEen-FIen-GBen-NLen-NOen-SEen-US | DefaultEnglish - AustriaEnglish - GermanyEnglish - FinlandEnglish - Great BritainEnglish - NetherlandsEnglish - NorwayEnglish - SwedenEnglish - United States |
| Finnish | fi | Default |
| French | fr | Default |
| German | de | Default |
| Italian | it | Default |
| Norwegian (Bokmål) | nb | Default |
| Polish | pl | Default |
| Portuguese | pt | Default |
| Spanish | es | Default |
| Swedish | svsv-FI | DefaultSwedish - Finland |


## How it is done

The table above lists all supported languages.  Other locales may fallback to supported versions. For example, `fr-GB` falls back to French translations. If a locale is unsupported (e.g., `zh-CN`), it falls back to English.  Locale is set in the `createOrder` or `updateOrder` API call using the `locale` property.

### Order configuration examples

**Example JSON (GB):**


```json
{
  "purchase_country": "GB",
  "purchase_currency": "GBP",
  "locale": "en-GB",
  "order_amount": 50000,
  "order_tax_amount": 4545,
  "order_lines": [
    {
      "type": "physical",
      "reference": "19-402-USA",
      "name": "Red T-Shirt",
      "quantity": 5,
      "quantity_unit": "pcs",
      "unit_price": 10000,
      "tax_rate": 1000,
      "total_amount": 50000,
      "total_discount_amount": 0,
      "total_tax_amount": 4545
    }
  ],
  "merchant_urls": {
    "terms": "https://www.example.com/terms.html",
    "checkout": "https://www.example.com/checkout.html?order_id={checkout.order.id}",
    "confirmation": "https://www.example.com/confirmation.html?order_id={checkout.order.id}",
    "push": "https://www.example.com/api/push?order_id={checkout.order.id}"
  }
}
```