Appearance
Translating with AI
Ask your connected AI assistant to find missing translations, translate whole option sets and keep your storefront texts translated.
Overview
When Claude, Claude Code or ChatGPT is connected to your store, it can work with storefront translations too. It saves the same translations you'd type in the app, so you can check and edit them there afterwards.
Your assistant can:
- List your store's languages and tell you whether shoppers see translations yet
- Find texts that are missing a translation or are outdated, in one option set, in some options, or across the whole store
- Translate option texts: labels, values, help text, placeholders, headings, item content, units and more
- Mark outdated translations as up to date, when the translation still fits
- Translate storefront messages and Style preset texts
- Remove one language's translations, for example after you stop selling in that language
Your assistant can't:
- Turn translations on or off, or tick Show translations on the storefront. Only you can, in Storefront Settings
- Change the original English text of a storefront message or preset text
- Translate built-in texts. Shoppers already see those in their language
Before You Start
- Your plan includes storefront translations. Without it, your assistant can still read translations but can't save or delete them
- Your store languages are loaded once in the app. Tick Turn on translations in Storefront Settings, then open any option set, click Translate and Allow access. See Set Up Translations
Your assistant can translate before Show translations on the storefront is on, so you can review everything first.
How It Works
- Ask your assistant what to translate, for example "Translate the Gift Wrapping option set into French"
- It checks your store's languages and reads the texts that need translating, with their originals
- For a large job, it previews the first batch before saving
- It saves the translations, a batch at a time, and tells you what it added, replaced or skipped
If you changed an original text while your assistant was working, it skips that text instead of saving an outdated translation. It asks you before replacing a translation that's already up to date.
Check the result in the app
Open the option set's Translations page and filter by language to review what your assistant saved. See The Translations Page.
Keeping Your Store Safe
- Each save counts as one change toward the limit of 30 changes a minute, however many texts it translates
- Removing translations always shows a preview first. Your assistant must show you what will be removed before it can delete anything. If the translations change after the preview, the removal is refused and it previews again
- Removing translations counts as a delete, toward the limit of 10 deletes an hour, shared with deleting options and option sets
- Changes need a recent sign-in. Like every change, saving translations needs your assistant's sign-in to be less than 7 days old. See Stay Connected
Renaming Through Your Assistant
When your assistant renames an option or value, or changes another original text, the translations of that text become Outdated, the same as in the app. Your assistant tells you, so you can ask it to translate them again.
Example Requests
- "Which languages can I translate into, and can shoppers see translations yet?"
- "Translate the Gift Wrapping option set into French."
- "Which texts are missing a German translation across the whole store?"
- "Show me the outdated Spanish translations in the Engraving set."
- "Mark the outdated German translations in the T-shirt set as up to date."
- "Translate the required-field message and the Edit in cart buttons into Italian."
- "Translate the File Upload preset's button label into Dutch."
- "I just added Japanese in Shopify. Refresh my languages."
- "Remove all Portuguese translations. I don't sell in Portuguese anymore."
Troubleshooting
| Your assistant says... | What to do |
|---|---|
| The store's plan doesn't include storefront translations | Upgrade on the app's Pricing page. Your assistant can still read translations |
| The store's languages aren't loaded | In the app, tick Turn on translations, then open any option set > Translate > Allow access and approve Shopify's prompt |
| The store has only its primary language | Add a language in Shopify under Settings > Languages, then ask your assistant to refresh your languages |
| A language isn't one of the store's languages | If you just added it in Shopify, ask your assistant to refresh your languages |
| A text is still the app's built-in English | Shoppers already see it in their language. To use your own wording, change the English text in the app first |
| Translations saved, but you can't see them in the app | Tick Turn on translations in Storefront Settings |
| Shoppers don't see the translations | Tick Show translations on the storefront in Storefront Settings |
For connection problems, see Troubleshooting.
Related
- AI Assistants (MCP) — connect an assistant, sign-in and limits
- Storefront Translations — setup, plan and what shoppers see
- What Can Be Translated
- Storefront & Style Texts