Translations

Overview

Spree supports two types of translations:

Resource Translations — translatable content fields on models like Products, Taxons, and Stores (e.g., product name, description, slug)
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. 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.

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 or the SDK locale option:

// 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',
})

// 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' })

# 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'

Slugs are also localized — a product can have different slugs per locale. See Slugs 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.

UI Translations

Spree stores UI translation strings in a separate project: Spree I18n. This is a community-maintained project with locale files for 43+ languages. To install UI translations:

spree bundle add spree_i18n

bundle add spree_i18n

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

The full list of supported locales is available in the Spree I18n GitHub repository.

Markets — Locale and currency configuration per geographic region
Localization — Locale, currency, and country headers in API requests
Slugs — Localized slugs and URL identifiers
Products — Product translations

Getting started

Platform

Catalog

Cart & Checkout

Fulfillment

Extensibility

Overview

Resource Translations

Translatable Fields

Store API

Managing Translations

UI Translations

​Overview

​Resource Translations

​Translatable Fields

​Store API

​Managing Translations

​UI Translations

​Related Documentation

Overview

Resource Translations

Translatable Fields

Store API

Managing Translations

UI Translations

Related Documentation