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

# Translations

> Translate Spree products, taxons, and other store content into multiple languages using Mobility-backed translations and locale-aware APIs.

## Overview

Spree supports two types of translations:

1. **Resource Translations** — translatable content fields on models like Products, Taxons, and Stores (e.g., product name, description, slug)
2. **UI Translations** — interface strings used in the admin panel (e.g., button labels, flash messages)

For configuring which locales and currencies are available in your store, see [Markets](/developer/core-concepts/markets). Markets control locale and currency assignment per geographic region.

## Resource Translations

Resources with user-facing content fields have built-in support for translations. Each translatable resource has a corresponding translations table in the database — for example, product translations are stored in `spree_product_translations`.

```mermaid theme={"theme":"night-owl"}
erDiagram
    Product ||--o{ ProductTranslation : "has many"
    Taxon ||--o{ TaxonTranslation : "has many"
    Store ||--o{ StoreTranslation : "has many"

    Product {
        string id PK
        string status
    }

    ProductTranslation {
        string id PK
        string product_id FK
        string locale
        string name
        text description
        string slug
        string meta_title
        string meta_description
    }

    TaxonTranslation {
        string id PK
        string taxon_id FK
        string locale
        string name
        text description
        string permalink
    }
```

### Translatable Fields

| Resource         | Translatable Fields                                                                                            |
| ---------------- | -------------------------------------------------------------------------------------------------------------- |
| Product          | `name`, `description`, `slug`, `meta_description`, `meta_title`                                                |
| Taxon            | `name`, `description`, `permalink`                                                                             |
| Taxonomy         | `name`                                                                                                         |
| Option Type      | `presentation`                                                                                                 |
| Option Value     | `presentation`                                                                                                 |
| Property         | `presentation`                                                                                                 |
| Product Property | `value`                                                                                                        |
| Store            | `name`, `meta_description`, `meta_keywords`, `seo_title`, `customer_support_email`, `address`, `contact_phone` |

### Store API

To retrieve translated content, pass the locale via the [`X-Spree-Locale` header](/api-reference/store-api/localization) or the SDK `locale` option:

<CodeGroup>
  ```typescript Store SDK theme={"theme":"night-owl"}
  // Fetch product in French
  const product = await client.products.get('spree-tote', {}, {
    locale: 'fr',
  })

  product.name        // "Sac Spree"
  product.description // "Un sac fourre-tout élégant..."
  product.slug        // "sac-spree"

  // List categories in German
  const { data: categories } = await client.categories.list({}, {
    locale: 'de',
  })
  ```

  ```typescript Admin SDK theme={"theme":"night-owl"}
  // Pass the locale as a request option to get translated content.
  // The Admin API resolves by prefixed ID only — slugs are not accepted.
  const product = await adminClient.products.get('prod_86Rf07xd4z', {}, { locale: 'fr' })

  const { data: categories } = await adminClient.categories.list({}, { locale: 'de' })
  ```

  ```bash cURL theme={"theme":"night-owl"}
  # Fetch product in French
  curl 'https://api.mystore.com/api/v3/store/products/spree-tote' \
    -H 'X-Spree-API-Key: pk_xxx' \
    -H 'X-Spree-Locale: fr'
  ```
</CodeGroup>

Slugs are also localized — a product can have different slugs per locale. See [Slugs](/developer/core-concepts/slugs#internationalization) for details.

### Managing Translations

Translations are managed in the Admin Panel. When editing a product, taxon, or other translatable resource, switch the locale selector to enter content in each language.

Translations can also be [managed via the Admin API](/developer/sdk/admin/quickstart).

## UI Translations

Spree stores UI translation strings in a separate project: [Spree I18n](https://github.com/spree-contrib/spree_i18n). This is a community-maintained project with locale files for 43+ languages.

To install UI translations:

<CodeGroup>
  ```bash Spree CLI (Docker) theme={"theme":"night-owl"}
  spree bundle add spree_i18n
  ```

  ```bash Without Spree CLI theme={"theme":"night-owl"}
  bundle add spree_i18n
  ```
</CodeGroup>

Once installed, all translation files are available automatically — no need to copy any files.

<Info>
  The full list of supported locales is available in the [Spree I18n GitHub repository](https://github.com/spree-contrib/spree_i18n/tree/main/config/locales).
</Info>

## Related Documentation

* [Markets](/developer/core-concepts/markets) — Locale and currency configuration per geographic region
* [Localization](/api-reference/store-api/localization) — Locale, currency, and country headers in API requests
* [Slugs](/developer/core-concepts/slugs) — Localized slugs and URL identifiers
* [Products](/developer/core-concepts/products) — Product translations