Storefront languages¶
Guide type: Explanation Difficulty: Beginner Applies to: Size charts and fit quizzes
SmartSize adapts to the language your shoppers see on your storefront. Understanding how storefront languages flow through SmartSize helps you decide what to translate and where.
How Shopify controls storefront languages¶
Your Shopify store defines which languages are available to shoppers. You configure these in Shopify admin under Settings > Languages.
A language must be published to appear on the storefront. Shoppers can switch languages using a language selector if your theme supports it, or they may land directly on a translated URL.
SmartSize reads the list of published storefront languages from Shopify. This list appears in SmartSize Global settings as the languages available for size chart translation.
How SmartSize detects the shopper's language¶
When a shopper opens a product page, the storefront passes the current language to SmartSize.
SmartSize uses this language to decide:
- which fit quiz text to show
- which size chart translation to render
- which button labels to display
The detection happens automatically. You do not need to configure language detection in SmartSize separately.
Fit quiz languages¶
SmartSize fit quizzes are already translated into 24 languages by the SmartSize team. When a shopper views a fit quiz, SmartSize matches the storefront language to the closest supported fit quiz language.
If the exact locale is supported — for example, pt-BR for Brazilian Portuguese — SmartSize uses it. If only the base language is supported — for example, fr for any French regional locale — SmartSize falls back to the base language.
If SmartSize cannot find a supported match, the fit quiz appears in English.
You do not edit fit quiz translations. If you need a language that is not yet supported, contact SmartSize support.
For the full list of supported fit quiz languages, see Fit quiz supported languages.
Size chart translations¶
Size chart content is controlled by you, the merchant. SmartSize does not auto-translate size charts unless you activate size chart translations and start an AI translation job.
Each size chart has a primary language — usually your store's default language. For every other published storefront language, you can create a translation using AI bulk translation, manual editing, or both.
When a shopper opens a size chart, SmartSize checks whether a translation exists for the current storefront language. If it does, the chart renders in that language. If not, the chart falls back to the primary language.
Button labels¶
The Size Chart and Find my size button labels are translated through Shopify Translate & Adapt, not inside SmartSize. This is because the buttons are part of the Shopify theme app embed, and Shopify manages app embed text translations.
To translate button labels, use Shopify Translate & Adapt > App embeds > SmartSize.
For detailed steps, see Translate SmartSize button labels.
What happens when a language is not supported¶
The behavior depends on what part of SmartSize the shopper is viewing:
| SmartSize element | Fallback behavior |
|---|---|
| Fit quiz | Falls back to the closest supported language, then English |
| Size chart | Falls back to the chart's primary language |
| Button labels | Falls back to the default text configured in the app embed |
Adding a new storefront language in Shopify does not automatically create size chart translations. You must activate size chart translations and generate the translations for that language.