Translate a New Shopify Theme Before You Publish It

A new Shopify theme starts with no translations. Here is how to translate an unpublished or development theme first, so launch day is not half English.

The LocaleFlow Themes to translate list, with an unpublished theme ticked and the live theme left unticked

You rebuilt the theme. It looks better, it converts better, and you publish it on a Tuesday morning. Then a customer in Germany opens the site, and the announcement bar, the cart drawer and the footer are all in English again.

This is one of the most common surprises in a multilingual Shopify store, and it is not a bug. It happens because of where Shopify keeps theme translations. Once you know that, the fix is simple, and you can do it before launch day rather than after.

Why a new theme starts untranslated

Shopify stores translations in different places depending on what is being translated.

Product titles, descriptions, collection text, page bodies, blog articles and metafields are attached to those records. They belong to the product, not to whatever theme is drawing it. Change the theme and they stay exactly as they were.

Theme content is different. The strings you edit in the theme customizer, plus the theme’s own locale files, are attached to that specific theme. A new theme is a new record, so it arrives with an empty translation set.

That is why a redesign feels like it deletes half your work. The catalogue is fine. The storefront chrome around it is not.

Flowy thinking

The short version

Your products keep their translations. Your theme does not. A new theme is a new record, and it starts empty.

What usually goes wrong

The common sequence looks like this.

  1. The agency or the in-house developer duplicates the live theme and starts rebuilding.
  2. Everyone tests the new theme in the source language, usually English, because that is what the preview shows first.
  3. The theme is published on a quiet morning.
  4. The translated markets suddenly show English navigation, English buttons and English announcement bars.
  5. Someone re-runs the translation, and the store sits half translated while the job works through the strings.

Nothing here is careless. The translated markets are simply not part of the normal theme review. The translations lived on the old theme, so nobody had a reason to look.

The fix: translate the theme before it goes live

LocaleFlow lists every theme in your store, not only the published one. On the Online Store tab you get a “Themes to translate” list, with each theme labelled by its role.

  • Live is the theme shoppers currently see.
  • Unpublished is a theme sitting in your theme library, including a duplicate you are rebuilding.
  • Development is a theme pushed from a developer’s machine with the Shopify CLI.

You tick whichever ones you want translated. The live theme can stay unticked, so the translation run touches only the new theme.

Then you click Restart translation. The card confirms with “Job queued. Translation will start shortly.” A green banner then reports that the job is active. New content will be translated automatically, and a Check status link sits next to it.

When it finishes, preview the unpublished theme with one of your languages selected. If the navigation, the buttons and the announcement bar read correctly, the theme is ready. Publish it, and the storefront is translated from the first minute.

What the translation run actually does

Each theme you tick is translated from your source language. LocaleFlow does not lift the strings out of your old theme and drop them into the new one.

That distinction matters more than it sounds. A rebuilt theme rarely uses the same strings as the old one, because sections get renamed, copy gets rewritten and new blocks appear. Translating from source covers the new strings, including the ones that never existed before.

Your controls still apply to the run:

  • Custom term translations keep your fixed wording, so a term you decided on last year is used again.
  • Blacklisted keys stay in the source language, which is what you want for brand names and product codes.
  • Custom prompt and per-language prompts hold the brand voice, so the new theme sounds like the old one.

The result is a new theme in the same voice as the theme it replaces, without anyone re-typing a glossary.

A checklist for a theme relaunch

Use this in the week before you publish.

  1. Duplicate the live theme, or push your development theme, so it appears in the theme library.
  2. Finish the copy in your source language first. Translating a theme that is still changing wastes a run.
  3. Open LocaleFlow, go to the Online Store tab and tick the new theme. Leave the live theme unticked.
  4. Click Restart translation and wait for the job to complete.
  5. Preview the unpublished theme with each target language and read the chrome, not the products.
  6. Fix anything that reads wrong using custom terms, then re-run.
  7. Publish the theme.
  8. Tick the newly published theme so ongoing edits keep syncing, and untick the retired one.

Step 8 is the one people forget. After the switch, the theme you are actively editing should be the one LocaleFlow keeps in sync.

What else is theme-specific, and what is not

It helps to know which parts of a store follow the theme and which do not, because it tells you what to check after a redesign.

Theme-specific, so it needs the run above:

  • Theme customizer content, including announcement bars, hero text and section headings
  • Theme locale file strings, including button labels, cart text and form labels

Not theme-specific, so it survives untouched:

  • Products, collections, pages, blogs and blog articles
  • Metafields and metaobjects
  • Menus, shop policies, storefront filter labels and delivery method names
  • Image alt text and product option names

LocaleFlow covers all fifteen resource types, so the same setup handles both groups. The only thing a redesign changes is which theme record the theme content belongs to.

Flowy thumbsup

Do this once

Add the translation run to your theme launch checklist, right next to the speed test. It takes one click and it removes the worst launch-day surprise in a multilingual store.


Try LocaleFlow with a free demo - see your actual store content translated.

Share this article

FAQ

Frequently Asked Questions

Do I lose my translations when I publish a new Shopify theme?+
You lose the theme-level ones. Shopify keeps theme content translations against each individual theme, so a new theme arrives with an empty set. Your product, collection, page, blog and metafield translations are stored on those records instead, so they survive the switch untouched. In practice that means the storefront chrome goes back to your source language while the catalogue stays translated.
Can I translate an unpublished or development theme?+
Yes. LocaleFlow's Online Store tab lists every theme in the store with its role, shown as Live, Unpublished or Development. You tick the ones you want translated, and you can leave the live theme unticked. That is what lets you prepare a redesign in the background while shoppers still see the current theme.
Does LocaleFlow copy my old theme's translations to the new theme?+
No. Each theme you tick is translated from your source language, not copied from another theme. Anything you have taught LocaleFlow still applies. That covers custom term translations, blacklisted keys and your custom prompt, so the new theme keeps the voice of the old one.
What happens to my product and page translations during a theme change?+
Nothing. Shopify attaches those translations to the product, collection, page or blog record itself, not to the theme rendering it. Swapping themes changes which template displays the content, not the content. Only theme content, meaning the strings you edit in the theme customizer and the theme's own locale files, is theme-specific.
How do I check the new theme is translated before I publish it?+
Tick the new theme in LocaleFlow, click Restart translation, and the card confirms with 'Job queued. Translation will start shortly.' A green banner then reports that the job is active, with a Check status link. Once it finishes, preview the unpublished theme in Shopify with a language switched on and read the storefront chrome.
Flowy celebrating

Ready to translate your Shopify store?

Install from the Shopify App Store and start translating in minutes.