All guides

Translation

Your edits are never overwritten

Which translations Toldo translates again and which it never touches: your edits, other apps' translations and the ones you had before Toldo.

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 only translates again the texts it translated itself and that nobody has edited since. If you change a translation, or another app does, Toldo keeps it as yours and never touches it again. The translations you had before Toldo are kept too, unless you choose to replace them; their URL handles are always kept.

The rule

Toldo only translates again the translations it wrote itself that nobody has changed since. Every other translation stays as it is.

To tell them apart, Toldo keeps a fingerprint of every translation it writes. When it reads your store again, it compares: if the translation in Shopify is no longer the one it wrote, someone edited it, and from then on it's yours. And just before writing, Toldo reads each text again: if you changed it while Toldo was translating, your version stays. Since Shopify can take a few seconds to show a translation that was just written or removed, for 10 minutes after writing or removing one Toldo doesn't mistake a difference for your edit; it doesn't touch the text in that time either, so if you edited it, it's yours afterwards.

What Toldo does with each text

What Toldo findsWhat it does
No translationTranslates it
Its own translation, up to dateNothing
Its own translation, and the original changedTranslates it again, except URL handles, which are kept
Its own translation, and you changed the variant, the tone, your notes, the glossary, the names never translated or the brand voiceTranslates it again with the new settings, except URL handles
A translation someone changed after Toldo read it (Toldo's, an imported one or yours)Keeps it as yours and never touches it again, not even with the replace option
A translation Toldo didn't make, from before you started using itKeeps it as imported; replaces it only if you turn on the replace option, and never if it's a URL handle
A translation Toldo didn't make, from after you started using itKeeps it as yours: never replaces it
A kept translation whose original changedLeaves it as it is and flags it for you to review
The original was emptied or removedRemoves Toldo's translation if it's still exactly what Toldo wrote and you haven't locked it; never removes someone else's

On the Review translations screen, yours are under Edited by you, the ones from before Toldo under Imported and Toldo's under By Toldo.

The translations you already had

When you choose your languages, Toldo first imports the translations already in Shopify for them, from Translate & Adapt, another app or made by hand, and keeps them as they are. The import sends nothing to any translation engine. After that, Toldo only translates what's missing.

If you'd rather have Toldo translate those too, turn on Replace translations made before Toldo (other apps or Translate & Adapt) in Translate → Settings, under Options. It comes off: "Off: they stay as they are and Toldo only fills in what's missing. URL handles made before Toldo always stay, so their URLs don't change." Even with it on, Toldo never replaces a translation you edited, or one someone made after you started using Toldo.

When the original of a kept translation changes

Toldo doesn't touch it: it leaves it as it is and flags it Original changed. On Translate you'll see the notice "… of your own or earlier translations kept their old text while the original changed. Review them when you can.", with the Review link. In the review you decide whether to keep it or let Toldo translate it again.

Frequently asked questions

Where do I edit one of Toldo's translations?

In Shopify, where you edit your translations, for example with the Translate & Adapt app. Toldo has no text editor: it notices your change the next time it reads that text, and from then on keeps it as yours.

What if I want Toldo to translate one I edited again?

In Translate → Review, find the translation under Edited by you and click Let Toldo translate it. Toldo translates it again in a moment.

Does changing my glossary replace my translations?

No. With a new glossary, names, brand voice, variant, tone or notes, Toldo only translates its own translations again. Yours and the imported ones stay as they are.