Docs/Storefront/Storefront Locales (i18n)

Storefront Locales (i18n)

Translate your storefront into multiple languages and let customers pick their preferred locale.

Storra storefronts can ship in multiple languages. Pick a default locale and add additional ones; the storefront serves the right translation based on each customer's browser language or explicit selection.

Set up

  1. Go to Online Store → Locales.
  2. Pick your default locale (e.g. en, de, fr).
  3. Add additional locales you want to support. Each becomes available in the customer's locale picker.

What gets translated

  • Theme UI strings (cart, checkout, "Add to cart" button labels, etc.) — shipped from each theme's locales/<code>.json file.
  • Storra-built emails (order confirmation, magic-link, refund notices) — shipped from Storra's i18n dictionary.
  • Customer notifications use the customer's preferred locale (set at first checkout).

What doesn't get translated automatically

  • Package names + descriptions — these are merchant-authored content. In the future, Storra will support per-locale package translations.
  • Custom pages (About, Rules, etc.) — same story; per-locale page versions are a future addition.
  • Category names + descriptions — also merchant-authored.

Locale negotiation

Storra checks (in order):

  1. Customer's explicit selection from the storefront locale switcher (stored in their account)
  2. The customer's previous selection (stored in a cookie)
  3. The browser's Accept-Language header
  4. Your store's default locale
Was this page helpful?Suggest an edit →

Updated recently