All guides

Translation

Translate your store with Toldo

What Toldo translates in your Shopify store, into which languages, where it saves the translations, when it updates them and what it sends to the engine.

Rolling outUpdated

This feature is rolling out: we're turning it on in stages with our founding partners. What this guide describes may change before general availability.

In short

Toldo translates your store into the languages you have enabled in Shopify: products, collections, pages, menus, the theme, notification emails and more. It saves every translation in Shopify itself, so they stay even if you uninstall Toldo. It translates when you click Translate now and, if you leave it on, your store's changes too; your own edits are never overwritten.

What Toldo translates

Toldo translates the texts of your store that Shopify lets you translate. On Translate, the Coverage table shows them under these names (grouped here by area):

  • Your catalog: Products (title, description, SEO title and description, URL handle and product type), Collections, Product options, Option values and the translatable Custom fields of your products and collections.
  • Your images: their alt text (Image alt text, Collection images, Blog post images).
  • Your online store: Store SEO, Pages, Blogs, Blog posts, Menus, Menu items, Filters, Custom content and Policies.
  • Your theme: Theme, Theme texts, Theme sections, Theme templates, Theme settings and App texts in the theme.
  • Emails and checkout: Notification emails, Packing slips, Delivery methods, Payment methods, Subscription plans and Subscription options.

Values that aren't text, such as links, files or JSON data, aren't translated. Inside your texts, Toldo protects what mustn't change, such as code (HTML, Liquid), links, numbers with their units, product codes and emoji.

For each product or collection, Toldo reads up to 50 custom fields. If Shopify doesn't let it read some type of content, Toldo skips it and tells you on Translate: "Toldo couldn't read some content (…). Approve the app's updated permissions in Shopify, then translate again."

Into which languages

Toldo translates from your store's main language into the languages you have enabled in Shopify, under Settings > Languages. In Toldo you choose which ones to translate, with each one's regional variant and tone: see Variants, tone, glossary and brand voice.

You can translate a language before you publish it in Shopify: your customers see it once you publish it. How many languages you can translate depends on your plan: see Translation cost and limits.

Where the translations are saved

In Shopify itself, in its translation storage. That's why your store's translated URLs, SEO and speed stay Shopify's own, and why the translations stay in your store if you uninstall Toldo.

The translations you already had in Shopify (from Translate & Adapt, another app or made by hand) are kept: when you choose your languages, Toldo first imports them as they are and only fills in what's missing. See Your edits are never overwritten.

When Toldo translates

  • When you click Translate now. Toldo goes through your whole store and translates what's missing or changed. It also works with automatic translation turned off.
  • With "Translate changes automatically" on, as it comes by default:
    • products and collections you create or edit are translated about 30 seconds after the change;
    • if you publish another theme, or add or change a language in Shopify, Toldo goes through your whole store again;
    • after each full pass, Toldo schedules the next one for a day later. That keeps pages, blog posts, menus, theme texts and emails up to date, which Shopify doesn't report when they change.

If you turn that option off, Toldo only translates when you ask it to: with Translate now or, in the review, with Let Toldo translate it and Translate again. A pass already under way finishes.

On a large store a full pass takes a while: Toldo works in steps and, if it's interrupted, picks up where it left off.

What you see on Translate

  • Languages: the languages you translate into, with their variant and tone, and the Settings and Review links.
  • This month: how many texts were translated, and the translation cost against what your plan includes.
  • Cost before you translate: what translating what's missing would cost, as of the latest estimate or full translation (what it found before translating). Estimate cost brings it up to date.
  • Coverage: by content type and language, what's Translated, what's left To translate and the texts Kept as they are, also as of the latest estimate or full translation.
  • Activity: every import, estimate, full translation or translation of changes, with its result.

A text that reads the same in the other language, such as a brand name, isn't saved as a translation (your store shows the original), so it keeps counting under To translate. Toldo doesn't pay for it again: it remembers it.

What goes to the translation engine

Only your store's content:

  • the texts being translated, from the list above;
  • what helps translate them well: each product's title, vendor, product type and collections;
  • your settings: the variant and tone, the glossary, the names never translated, your brand voice and your notes for the translator.

To translate, Toldo never reads your store's customers or orders. If the content being translated holds personal data, for example names in reviews stored in custom fields, it's sent like the rest of the text. Notification emails go as templates: their Liquid code is protected, and they carry no customer's data.

The translation engine is Claude, by Anthropic. For texts Claude doesn't translate, Toldo can use DeepL or Google Cloud Translation as a second engine. If Translate shows "Translation isn't available on this server yet: no translation engine is configured", it isn't open for your store yet, and nothing is sent anywhere. See also Privacy and your data.

Steps to get started

  1. Enable your languages in Shopify. In your Shopify admin, go to Settings > Languages and add the languages you sell in.
  2. Open the Translate settings. In Toldo, open Translate and click Settings (or Choose languages, if you have none yet).
  3. Choose your languages. Tick Translate into … for each language, check its Variant and Tone, and click Save. Toldo imports the translations you already had and estimates the cost.
  4. Check the cost. On Translate, look at Cost before you translate.
  5. Translate. Click Translate now. When it's done, Activity shows the result. Coverage and Cost before you translate still show what the translation found before it started: to bring them up to date, click Estimate cost.

Frequently asked questions

Are the translations deleted if I uninstall Toldo?

No. They're saved in Shopify, so they stay in your store. On its side, Toldo only keeps a memory of the fragments it has translated, which is deleted with the rest of your store's data 48 hours after you uninstall: see Privacy and your data.

Does Toldo send my customers' data to the translator?

No. It only sends your store's content: the texts being translated (the list above: products, collections, pages, blogs, menus, the theme, policies, email templates, custom fields, custom content and more), what helps translate them well (each product's title, vendor, product type and collections) and your translation settings. To translate, it never reads your store's customers or orders. If that content holds personal data, for example names in reviews stored in custom fields, it's sent like the rest of the text.

Can I stop Toldo from translating changes on its own?

Yes. In Translate → Settings, under Options, untick Translate changes automatically and click Save. From then on, Toldo only translates when you ask it to: with Translate now, or with Let Toldo translate it and Translate again in the review. A pass already under way finishes.

Does Toldo translate my product URLs?

Yes, if you leave Translate URL handles (translated links) on, as it comes by default. Toldo translates each handle once and then never changes it on its own, even if the original changes: changing a URL would break the links that already point to it. The exception is handles translated before Toldo: if you turn on Replace translations made before Toldo (other apps or Translate & Adapt), it replaces those too. See Your edits are never overwritten.