Adding French and Spanish to a Shopify Store Without Breaking It

  • Alek Tysklind
  • 3 min read
Diagram: the tag Demo is translated into French and Spanish, so the theme can no longer find a match

When we added French and Spanish to our own Shopify store, auto-translation did a good job on the words. It also quietly broke parts of the site, because it translated things that were never meant to be words. If you are about to add a language to your store, this is worth knowing first.

What happened

Shopify's translation tools can translate almost everything in a theme, including its settings. Most settings hold text a visitor reads. A few hold identifiers: the name of a blog or article the theme should look up, a tag it should filter by, a key it uses to find something else. To a translation tool, "Demo" is just an English word, so it became a French word and a Spanish word.

The theme then went looking for items with the French or Spanish tag, found none, and carried on as if nothing was wrong.

What we saw

  • A featured slider that worked in English stopped working in French and Spanish and showed an error instead of projects.
  • Articles that are meant to stay out of the main catalogue appeared in it again, because the tag that hides them no longer matched.
  • Projects we had pinned to the top stopped being pinned.

The English site looked perfect throughout, which is why this kind of problem survives: whoever built the store checks it in their own language.

How we approached it

  1. Look for what the broken places share. Every one of them was a setting the theme looks up or compares against, not one it displays.
  2. Remove only those translations. We saved a backup first, then removed the translations for those few fields in both languages and left everything else translated.
  3. Test each language page by page. A home page that looks right says little about the catalogue, the slider or the forms behind it.

Other things translation changes

  • Page addresses. The Spanish version of the About page got a Spanish web address. Links in the theme that assumed the English address stopped lining up, so we mapped them back.
  • Longer words. Headings that fit nicely in English were too big on phones once the French and Spanish words were longer, so we capped heading sizes for non-English languages on small screens.
  • Things that cannot be translated. Article tags stay in English in Shopify. We decided to accept that rather than work around it.

What to watch for

  • Re-running auto-translation can bring the problem back. Keep a short list of identifier fields and skip them every time.
  • The rule of thumb: if a setting is a handle, a tag, a key or an ID, do not translate it. If a visitor reads it, translate it.

What to take from this

Before you switch a language on, ask yourself:

  • Which settings in my theme are looked up rather than displayed?
  • Has anyone clicked through every page in the new language, including the catalogue and the checkout?
  • Do my links and page addresses still work in each language?
  • Who will re-check the store the next time translations are updated?

If you are planning a multi-language store and want a second pair of eyes before you switch it on, book a free discovery call and we will look at it with you.

Alek Tysklind

Desarrollador de temas de Shopify con más de 10 años de experiencia ayudando a empresas a crecer en línea.

¿Estás trabajando en una tienda de Shopify?

Cuéntame qué estás construyendo y dónde te has atascado. Lo revisaremos juntos en una llamada de diagnóstico gratuita.

Reserva una llamada de descubrimiento gratuita

Proyectos seleccionados

Sigue leyendo