Skip to content

Translating the Size Guide and Find My Size buttons #new

SmartSize's storefront buttons — the Size Guide trigger and the Find My Size quiz button — are rendered by your theme's App embed. Their text is split across two Shopify-native surfaces:

  • The default English label lives in the App embed in your theme editor.
  • Per-language translations live in Shopify's free Translate & Adapt app.

Shoppers automatically see the version that matches their language. If a translation is missing for a given language, the default label is shown instead.

Prerequisites

  • Translate & Adapt is installed. It's a free Shopify app — install it from the App Store if you don't already have it.
  • The language is added to a market. In your Shopify admin, go to Settings → Languages (or Settings → Markets → [your market] → Languages) and make sure the target language is added and published.
  • International routing is configured if you want shoppers to see the translation automatically. Shopify requires international subfolders or subdomains for per-language storefronts. See Managing international domains.

Step 1 — Set the default label in your theme

The default label is what shoppers see when no translation is available for their language.

  1. From the SmartSize app, open Global Settings → Button size charts → Translations (or Button size quiz → Translations) and click Open theme App embed. This deep-links you straight to the right App embed in the theme editor.
  2. For the SmartSize – Size chart embed, edit the Button text field. Default: SIZE GUIDE.

  3. For the SmartSize – Size quiz embed, edit:

  4. Smartrecom button label — default: FIND MY SIZE

  5. Smartrecom recommendation text — default: Your size is [[recommendedSize]]
  6. Click Save in the theme editor.

⚠️ Keep [[recommendedSize]] intact in the recommendation text. It's a placeholder that's replaced at runtime with the shopper's recommended size. Translate the surrounding words, not the placeholder itself.

Step 2 — Add a translation in Translate & Adapt

  1. From the SmartSize app, click Open Translate & Adapt on the Translations subsection. (Or open it from your Shopify admin: Apps → Translate & Adapt.)
  2. Pick the target language from the language switcher at the top of the Translate & Adapt window.
  3. Scroll to the Theme section and click App embeds.

  4. Pick the embed you want to translate:

  5. SmartSize – Size chart — has one row: Button label.

  6. SmartSize – Size quiz — has two rows: Smartrecom button label and Smartrecom recommendation text.
  7. Type your translation in the right-hand column. Translate & Adapt can also auto-translate via Google Cloud — review the suggestion before saving.
  8. Click Save.
  9. Repeat for every language you want to support.

Step 3 — Verify on the storefront

  1. Open your storefront in the target language. The fastest way is to append the language locale to the URL (e.g. /fr/, /de/) or use the language selector in your theme.
  2. Confirm the button label appears in the translated language.
  3. For the size quiz, run the quiz end-to-end and confirm the recommendation message also appears in the translated language with the recommended size correctly inserted.

Troubleshooting

The button still appears in English

  • Confirm the language is published in Settings → Languages, not just added.
  • Confirm you saved the translation in Translate & Adapt for that exact language.
  • Make sure international routing is configured — without subfolders/subdomains, Shopify can't switch languages per shopper.
  • Hard-reload the storefront (Cmd/Ctrl+Shift+R). Storefront caching can serve a stale version for a minute.

I edited the App embed but nothing changed

  • Make sure you saved the theme. App-embed edits don't auto-publish — clicking Save in the top right is required.
  • Make sure you edited the published theme. If you're working in a draft theme, the change only takes effect after you publish it.

The recommendation message is showing the literal text [[recommendedSize]]

  • The placeholder must be kept exactly as-is, including the double square brackets. If it was deleted or replaced with translated brackets, the quiz can't substitute the recommended size.

Need a language we don't support yet?

Translate & Adapt supports every language Shopify supports. If you can publish the language in Settings → Languages, you can translate the SmartSize buttons into it. If you run into issues, contact our support team — we'll help you set it up at no extra cost.