All guides

Translation

Variants, tone, glossary and brand voice

How you choose each language's regional variant and tone, a market's own wording, the glossary, the names never translated and your brand voice.

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

Under Translate → Settings you choose, for each language, the variant you sell in (for example Mexican or Spain Spanish) and the tone, informal or formal. You can also give a market its own wording, set how certain terms are translated with a glossary, protect the names that are never translated and describe your brand voice.

Each language's variant and tone

Under Translate → Settings, in Languages, each language enabled in Shopify has its Translate into … checkbox and these fields:

  • Variant: the regional variant you sell in. Toldo writes with its vocabulary and spelling: in Mexican Spanish, "celular" and "playera"; in Spain Spanish, "móvil" and "camiseta".
  • Tone: informal or formal, which decides how the customer is addressed: in Spanish, "tú" or "usted" ("vos" in Argentine Spanish); in Brazilian Portuguese, "você" or "o senhor / a senhora".
  • Notes for the translator (optional): instructions for that language, up to 500 characters. If you write more, the settings aren't saved and Toldo tells you: "Notes for the translator can have up to 500 characters per language."

You can translate into any language you enable in Shopify. Toldo has its own guidance for these variants: Mexican, Argentine, Colombian, Chilean, Peruvian, US and Spain Spanish, and neutral Latin American Spanish; Brazilian and European Portuguese; American and British English; French from France and Canada, German and Italian.

The variant shown first follows the language you enabled in Shopify (for example, Brazilian or European Portuguese) and your store's country, when that language has a variant of its own there: Canadian French on a store in Canada, Austrian German on one in Austria. When it doesn't, it's the language's usual variant: on a store in Mexico, English is US English and German is the German of Germany. The default tone is informal, except in German, French, Japanese and Korean, where it's formal.

A market's own wording

If your store has markets in Shopify, the Markets section lets you give a market its own wording in a language, for example, on a Mexican store that translates into English, UK English for the UK market. This is only for the languages you translate into, not for your store's main language. For each market and language you choose a variant, or leave Same as … so the market uses the language's translation.

Toldo writes the market's translation only where it says something different from the language's translation. And only for content Shopify lets you translate per market, such as products, collections, pages and menus: the theme, emails, and delivery and payment texts always use the language's translation.

A market's own wording doesn't count as another language in your plan.

Glossary

Under Glossary you set how you want certain terms translated, one line per term: original = translation. There's one glossary per language (Glossary for …), and it applies to all its variants. Across all your languages, the glossary takes up to 500 entries, of at most 120 characters on each side.

When it translates with Claude, Toldo gives it your glossary with every translation request and asks it to always use those translations. If an answer doesn't follow it, Toldo still saves it. DeepL and Google Cloud Translation, when Toldo uses them (for texts Claude doesn't translate, or for everything when Toldo's server doesn't have Claude configured), don't get the glossary, your notes for the translator or your brand voice.

Names never translated

Under Never translate you write, one per line, the brands, product lines and names that must stay as they are. Write them as they appear in your texts, capitals included: Toldo protects them as whole words. It takes up to 200 names of at most 120 characters.

Brand voice

Under Brand voice you describe how your texts sound, for example "warm, simple, proud of Mexican craft". It's optional and takes up to 500 characters.

  • Review SEO texts and product titles with a stronger model: on by default. A second Claude model reviews SEO titles and descriptions and product titles. If in a month you reach 80% of the translation your plan includes, Toldo stops this review for that month, and when Toldo's server doesn't have Claude configured, it doesn't happen.
  • Translate URL handles (translated links): on by default. Each handle is translated only once.

Toldo also checks every translation before saving it: that it keeps the code, links, numbers and protected names, that it isn't left untranslated, and that SEO titles stay within 60 characters and SEO descriptions within 160. If an answer fails, it asks again with what needs fixing.

If you change the settings

In the next pass, Toldo translates again its own translations the change affects: a language's, if you change its variant, tone, notes or glossary, and every language's, if you change the names never translated or the brand voice. URL handles, your translations and imported ones don't change. When you save, Toldo estimates what it would cost.

Steps to set up your languages

  1. Open the settings. In Toldo, open Translate and click Settings.
  2. Choose each language. Tick Translate into … and choose the Variant and the Tone. If you like, write your Notes for the translator (optional).
  3. Adjust your markets. Under Markets, choose a variant for any market that needs its own wording, or leave it on Same as ….
  4. Add your glossary and your names. Fill in Glossary, Never translate and Brand voice.
  5. Save. Click Save. Toldo confirms: "Saved. Toldo is estimating the cost of the new settings."

Frequently asked questions

Does the glossary apply to every variant of a language?

Yes. The Spanish glossary applies to every Spanish variant you translate into, such as Mexican and Spain Spanish.

Why doesn't a language show in the settings?

Because it isn't enabled in Shopify: the settings show the languages you have under Shopify's Settings > Languages at the moment you open them. Add it there, then open Toldo's settings again.

Does changing the settings cost anything?

It can: Toldo translates the translations of its own that the change affects again with the new settings, and that translation counts like any other. Before that, when you save, Toldo estimates the cost under Cost before you translate. See Translation cost and limits.