Shopify Multilingual Mayhem: When Your English Translations Vanish & Locales Go Rogue

Hey everyone! Your Shopify migration expert and community analyst here, diving into a really interesting, and frankly, quite stressful, situation that popped up in the forums recently. It's a prime example of how complex multilingual setups can get, and why sometimes, what seems like a simple fix can unravel into a store-wide headache.

The thread, started by rcnir, detailed a nightmare scenario: all English translations mysteriously disappeared from their live production store after a seemingly innocent drag-and-drop replacement of a theme locale JSON file (specifically en.default.json). But it wasn't just missing English text; the whole language structure of the store went haywire. Let's break down what happened and what we learned from the community's collective wisdom.

The Disappearing Act: More Than Just Missing Words

Imagine this: your store's original content is in Japanese, but you support 11 languages, including English, for your global customers. Then, after updating a theme file, your English translations vanish. To make matters worse, Shopify starts treating English as the default language, even though your actual content is Japanese. When rcnir exported translations, there was no en column (because it was now supposedly the 'source'), but a ja column appeared as a 'target' language, which is completely backwards!

This wasn't just a cosmetic glitch. Overseas customers couldn't read the site, order notifications were acting strangely, and sales were definitely taking a hit. This is the kind of thing that makes a store owner's heart sink.

Understanding Shopify's Language Architecture: Two Systems at Play

The most crucial insight came from community members like khadar and HamidEjaz, who quickly pointed out that this wasn't a typical translation import/export problem. The core issue was a deep inconsistency in the store's language configuration. As HamidEjaz eloquently put it, there are "two separate systems in play here":

  • Theme Locale Files (e.g., locales/en.default.json): These files primarily govern the text strings within your theme itself – things like button labels, UI elements, and other theme-specific phrases. The .default suffix indicates the theme's source locale.
  • Store's Primary Language (Settings > Languages): This is the overarching, store-level setting that dictates your canonical default language and manages all your translatable content across products, collections, notifications, and other global resources.

The critical takeaway? Replacing a theme locale file should not, under normal circumstances, flip your store's primary language or mess with your global translation resources. But in rcnir's case, Shopify Support confirmed that the store's default language had changed from Japanese to English, with no manual intervention from the admin, API, or apps. This pointed to a serious backend issue.

The reason the en column disappeared from the CSV export became clear too: the export only includes columns for target languages you translate into, not the source language. So, if Shopify mistakenly thought en was the source, it wouldn't export it, and ja would incorrectly show up as a language to be translated.

What to Do (and More Importantly, What NOT to Do) When Your Locales Go Rogue

This situation demanded extreme caution. Here's the best advice from the thread, synthesized for any merchant facing a similar crisis:

Immediately AVOID These Actions:

  • Do NOT import any translation CSVs. You could overwrite or further corrupt your data.
  • Do NOT change Markets language settings. This could solidify the incorrect default.
  • Do NOT switch default languages manually. Again, risk of further corruption.
  • Do NOT run translation apps or bulk API updates. Pause all automated and manual translation processes.
  • Do NOT make extensive theme changes. While a specific rollback is safe, general editing might complicate things.

rcnir wisely followed this advice, stopping all operations until Shopify's technical team could investigate.

Immediate, Safe Steps You CAN Take:

  1. Document Everything: Take screenshots of all relevant settings: Settings > Languages (showing the incorrect default), your domain settings (if they show a different default), and any other inconsistencies. This provides critical evidence for support.
  2. Contact Shopify Support (and escalate if needed): Open a ticket immediately. Clearly explain the symptoms, the timeline of events, and what you've already observed (e.g., the default language mismatch). Ask for:
    • Confirmation of the current canonical default locale.
    • Whether original translation resources still exist in the backend.
    • Whether locale identifiers changed during any delete/recreate operation.
    • Whether a backend restoration from before the incident is possible.
  3. Perform a Theme Rollback (for theme files only): As HamidEjaz suggested, you can safely revert your theme files using theme version history. Go to Online Store > Themes, click the ... menu on your theme, then Older versions. Roll back to a version just before the problematic drag-and-drop event (e.g., July 8th in rcnir's case). This restores your theme's .json files without touching the store-level language settings. rcnir did this as an isolation step.

The Support Escalation Challenge

One of the most frustrating aspects for rcnir was the support experience. Even after Shopify Support confirmed the default language change and that it wasn't user-initiated, getting clear answers on restoration timelines, team ownership, or progress updates was a struggle. For a live production store, where sales, SEO, and customer experience are on the line, vague "soon" responses are incredibly stressful and unhelpful. This highlights a critical need for clearer communication and escalation paths for backend issues that impact core store functionality.

Final Thoughts for Multilingual Merchants

rcnir's experience is a powerful reminder for all merchants running multilingual Shopify stores, especially those whose primary language isn't English. Be incredibly careful when modifying theme locale files, and understand that they are distinct from your store's global language settings. If you ever encounter similar symptoms – a discrepancy between what your store should be doing and how Shopify is treating your default language or translations – stop, document, and engage support for backend investigation. These aren't issues you can typically fix from the admin panel; they require specialized technical teams.

The community discussion helped rcnir understand the core issue was a store-level language resource mismatch, not just a theme file problem. This distinction is vital for accurate diagnosis and for pushing Shopify Support towards the correct backend resolution. It's a complex system, and sometimes, even the experts need to pool their knowledge to untangle these kinds of knots!

Share:

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools