How to Fix the 'Translation Missing' Error on Shopify

You ship a translation, refresh your storefront, and instead of a button label you see something like 'translation missing: de.cart.checkout.' It's an unsettling error to find on a live store — but in almost every case it's caused by a small handful of issues, and the fix usually takes less time than diagnosing the panic. Here's the practical checklist.

What Does 'Translation Missing' Mean on Shopify?

'Translation missing' is the fallback Shopify renders when a translation key referenced in your theme has no value in the active language. It usually appears as 'translation missing: <locale>.<section>.<key>' — for example 'translation missing: de.cart.checkout.' The error always tells you exactly which key is missing; that string after the colon is the breadcrumb to the fix.

Step 1: Identify the Missing Key

Look at the visible string on the storefront. It will follow the pattern 'translation missing: locale.section.key' — for example 'translation missing: fr.products.add_to_cart.' That tells you the locale (fr), the section (products), and the key (add_to_cart). Note all three pieces — you'll need them in the next step.

Step 2: Check Your Theme's Locale File

From your Shopify admin, go to Online Store → Themes → Edit code. Open the 'locales' folder and find the file matching the missing locale (e.g. 'fr.json'). Search for the missing key. If it's not there, that's your fix: add the key with the correct translation. If it is there but the value is empty, fill it in. Save the file and refresh the storefront — the missing string should disappear. (Shopify's locale documentation covers the file format if you need a reference.)

Step 3: Check the Schema Locale File

Some translation keys live in the schema-specific locale file (e.g. 'fr.schema.json' or 'fr.default.schema.json'). If the missing key relates to theme settings or section labels in the editor (not customer-facing copy), it likely belongs in the schema file. Add the translation there, save, and refresh the theme editor.

Step 4: Use Translate & Adapt or Your Translation App

If you're managing translations through the Translate & Adapt app or a third-party translation app like Lokalize, the missing key is probably visible in the app's interface as an empty field. Find the corresponding string and either auto-translate it or fill it in manually. Translation apps push their values into the storefront, so this is usually faster than hand-editing JSON files — and it keeps your translations consistent across theme updates.

Step 5: Re-Check After a Theme Update

Theme updates routinely introduce new translation keys. If 'translation missing' errors appeared right after you updated your theme, that's almost certainly the cause: your existing locale file doesn't have entries for keys the new theme version expects. Compare your live theme's locale files to the new theme's English locale file and copy any missing keys across, then translate them.

Why Is My Shopify Translation Missing?

There are four common causes: a translation key in the theme that has no value in the active language's locale file, a custom theme section that doesn't expose all its strings to the locale file, a theme update that introduced new keys, or a translation app that hasn't been re-run after a content change. Walk through them in that order — most cases are caught by the first two.

How Do I Prevent Translation Missing Errors?

Two habits prevent most of these errors. First: every time you publish a new language or update your theme, do a smoke-test pass on the homepage, product page, cart, and checkout in that language and look for the literal string 'translation missing.' Second: if you run a translation app, re-run a sync after any theme update so any new keys get auto-translated. (If you haven't built one yet, our glossary guide covers the other half of this hygiene.) A five-minute review after each change beats troubleshooting a live error in front of a customer.

Does Shopify's Live Chat Help With Translation Missing Errors?

Shopify support can help with platform-level issues, but 'translation missing' is almost always a theme-level fix that you (or your theme developer) need to make in the locale file. Most translation app vendors — including Lokalize — will help you find the missing key if you contact support. If the missing key is in a custom theme, your theme developer is usually the fastest path.