# Locales

> The locales enabled for your catalog, which its translatable content can be written in.
{/* generated:versioned-pages - edit _pm-authored, not this file */}

A **Locale** is a language your catalog's translatable content - product titles, option labels, supplier names - can be written in. Enable a locale here, then read or write translations in it with the `Flowkiwi-Locale` header.

Exactly one locale is the **default** at any time (its `default` is `true`): the one content is authored in and falls back to. You don't change it here but through the [Default locale](/api/product-management/default-locale/) resource.

A locale is identified by its `code`, in the `ll` or `ll-CC` format - such as `fr`, `en-US` or `de-DE`. There is no update: enable or delete a locale.

## The Locale object

## Common workflows

- **Sell in a new language.** Create the locale, then write translations with `Flowkiwi-Locale` set to its `code`.
- **Switch the default.** [Set the default locale](/api/product-management/default-locale/update/) to another enabled locale.
- **Retire a language.** Delete a non-default locale. Its translations are not deleted - they stay stored as orphans and are simply no longer reachable.

## Conventions

### Authentication and headers

All requests require an OAuth 2.0 bearer token:

```
Authorization: Bearer <token>
```

Reading requires the `instance_params:read` scope; writing also requires `instance_params:write`.