Appearance

Languages & Currencies ​

Selling internationally means presenting the right language, currency, and (for some languages) text direction. The theme fully supports Shopify's multi‑language & multi‑currency features. Setup, however, lives in Shopify Admin, not inside the theme editor.

TIP

Think of the theme as a display layer. Shopify (and apps) supply translations, localized prices, and market context; the theme renders what it is given.

Key Concepts ​

  • Languages: Added & published in Admin → Settings → Languages.
  • Currencies / Pricing: Managed through Shopify Markets (Admin → Settings → Markets).
  • Translations: Product descriptions, page content, blog posts, metafields, etc. require a translation mechanism (Shopify's own or an app). The theme cannot auto‑translate merchant‑authored content.
  • Theme Text Strings: Built‑in interface phrases (e.g. "Add to cart", "Search") are included in the theme's locale JSON files and switch automatically per published language.

Adding Languages ​

  1. Go to Settings → Languages in Shopify Admin.
  2. Add / request the language(s) you need.
  3. Provide or import translations.
  4. Publish the language so it becomes selectable in the storefront.

Refer to Shopify's guide: Add and manage languages.

::: important Unpublished languages will not appear in the theme's language selector even if translation data exists. :::

Adding Currencies (Markets) ​

  1. Go to Settings → Markets.
  2. Create or edit a Market grouping the regions you serve.
  3. Enable the desired currencies and (if needed) domains / subfolders.
  4. Configure duties, pricing adjustments, and rounding rules as needed.
  5. Save.

Shopify doc: Markets overview.

::: note Currency availability and automatic conversion are determined by Markets; the theme reads formatted money strings provided by Shopify. :::

Translating Content ​

You have two main options:

  1. Shopify Translate & Adapt (first‑party, free): App link
  2. Third‑party translation apps: Search apps

TIP

Start with Translate & Adapt if you only need a few languages or custom overrides. Move to a specialized app for bulk machine translation workflows, glossary management, or external TMS integration.

What The Theme Does (and Doesn't) Translate ​

Type of TextSourceAuto Switches?
Theme UI strings (buttons, labels)Theme locale filesYes
Product titles / descriptionsYour catalog dataOnly if translations supplied
Blog posts & pagesContent entriesOnly if translations supplied
Metafield textMetafield valuesOnly if translations supplied
Custom section text you typeTheme EditorOnly if translations supplied

WARNING

The theme cannot infer translations. Missing translations default to the primary language.

Third‑Party Translation Apps ​

App developers are responsible for compatibility with Online Store 2.0 and theme architecture. If you encounter an issue isolated to their translation injection logic, contact their support first. Provide:

  • Theme name & version
  • Steps to reproduce
  • Market / language context

Enabling Language & Currency Selectors ​

The theme includes built‑in selectors (usually Header and/or Footer sections):

  1. Open Online Store → Themes → Customize.
  2. Open the Header (or Footer) section.
  3. Enable the Language selector and/or Currency selector toggles.
  4. Save.

::: note Selectors only list languages & currencies that are both configured and published in Admin. :::

Right‑to‑Left (RTL) Language Support ​

RTL support is enabled by default for these ISO language codes: ar, fa, he, ur, ps.

You can adjust which languages trigger RTL:

  1. Theme Editor → Theme settings → Appearance.
  2. Find the RTL Layout group.
  3. Edit the field:
RTL languages
ar,fa,he,ur,ps
Comma-separated ISO language codes that should display the store in a right-to-left direction (e.g. ar, fa, he).

TIP

Keep only languages that genuinely require RTL. Removing a code forces LTR rendering even if the language itself is normally RTL.

How RTL Works ​

When the active language code matches one in the list, the theme sets dir="rtl" at the root container and flips directional styles (margins, padding, icon chevrons, carousels) where needed.

Troubleshooting ​

Language isn't showing in the selector

Is it published in Admin? Unpublished or incomplete languages are hidden.

Currency selector missing a currency

Confirm the Market includes that currency and visitor location / domain matches the Market rules.

Layout looks partially mirrored

Check if custom CSS or third‑party app blocks inject LTR‑specific directional styles overriding the theme's RTL adjustments.