All guidesShopify maintenance

Shopify theme editor not working: find the cause, then fix it without breaking the store

A check order for a Shopify theme editor that will not load, changes that do not show on the live store, and colours that will not change, with the fix and the safe rollback for each.

The short version

When the Shopify theme editor will not load, or saved changes do not reach the live store, the cause sits in one of four places: your browser, your theme's code, an app, or a setting that points the change somewhere you are not looking (a draft theme, another template or another market). Rule out the browser first with a private window. Then open a fresh free theme in the editor. If that loads and yours does not, the fault is in your theme's code or an app attached to it. Change nothing on the live theme until you have duplicated it.

Name the symptom before you change anything

Theme problems fall into three groups: the editor itself will not open, the editor works but the live store does not show your change, or one setting refuses to take effect. Each group has a different first check, so name yours before anyone edits code.

What you seeLikely layerFirst check
The editor stays blank, spins, or says it failed to loadBrowser, Shopify, or theme codeA private window, then a fresh free theme in the editor
"HTML error found" or "Theme error" in the editorTheme codeThe Liquid file the warning names
The editor jumps to another page or domainA redirect in theme code or an appScripts that redirect visitors
Changes saved but the live store looks the sameWrong theme, template or marketWhich theme is live, and the Market drop-down
A section shows on one product and not anotherTemplate assignmentThe product's Theme template setting
Colours or fonts will not changeColour system, section overrides, custom CSSWhether the section has its own colour setting
It worked yesterday and broke todayAn app, a theme update or a staff editThe Store activity log

Then write down what changed in the last 48 hours: a new app, a theme update, a code edit, a new market. The most recent change is your best lead, and the steps below check it in order of cost.

Rule out your browser and Shopify itself first

If the editor fails on your laptop and works on someone else's, the theme is fine. Shopify's theme troubleshooting page starts here too.

  1. Open the editor in a private window. If it loads there, a browser extension or stale cache is the cause. Clear cache and cookies, then turn extensions back on one at a time, starting with ad blockers and privacy tools.
  2. Try another device or network. Shopify suggests another device, the Shopify mobile app, and mobile data in place of office Wi-Fi. It also names VPNs and firewalls that block Shopify, which matters in offices with managed networks.
  3. Update the browser. Shopify's supported browsers page covers the latest two versions of the major browsers and recommends the latest Chrome. Shopify's troubleshooting page also advises against blocking all cookies.
  4. Check Shopify's status. Shopify's status page lists Admin and Storefront as separate components. If Admin shows an incident, wait it out and change nothing.

If the editor fails in a private window, on a second device and on mobile data while Shopify reports no incident, the cause is in the store. Move to the next section.

If the editor will not load, test a clean theme

A fresh, unedited theme is the quickest way to split the problem. If it opens in the editor and yours does not, the fault is in your theme's code or something attached to it. If every theme fails, look at your store's apps and settings.

Add a free theme from the Theme Store, or a fresh copy of your own theme, from Online Store, then Themes. Adding a theme does not publish it. Shopify's guidance then splits three ways:

  • Only your customized theme fails. A code edit is the likely cause. Restore the affected file from its history (covered below), or ask whoever edited it last.
  • A fresh copy of your theme fails too, in its latest version. The theme itself has a fault. Contact the theme's developer.
  • Every theme fails. Look at apps and store settings, starting with apps added or updated recently.

Error messages and what they point to

Shopify lists "HTML error found", "Theme error" and "The theme you're looking for couldn't be found" as code errors. The first two name the Liquid file at fault. Shopify gives the causes as invalid Liquid, broken HTML in an included snippet, or a network connection problem. Fix the named file, then open the editor again.

Two limits catch stores that have grown section by section. Shopify's JSON template documentation allows up to 25 sections per template and 50 blocks per section, and every section a template lists, apart from app sections, must exist in the theme or the template errors. So a developer who deletes a section file that a template still uses breaks that page in the editor. Separately, the error "Exceeded maximum number of unique handles for all_products" usually means too many Featured product sections on the home page, typically more than 20. Shopify's fix is to remove some or use a Featured collection section.

When the editor jumps to another page

If the preview inside the editor keeps redirecting, a script in your theme or an app is sending visitors elsewhere, such as a country redirect or a login wall. Shopify's fix is for the developer to skip the redirect when window.Shopify.designMode is true, which it is only inside the editor. Your customers keep the redirect and you get the editor back.

Saved changes that do not show live are usually in the wrong place

When the editor saves and the live store looks unchanged, the change almost always went somewhere other than where you are looking. Check these four places in order.

  1. The live theme. Shopify's publishing page says only one theme can be published at a time. Under Online Store, then Themes, confirm the theme you edited is the one marked live and not a draft copy. Theme updates create drafts named "Updated copy of", which makes this easy to mix up.
  2. The market. Shopify's troubleshooting page says to use the Market drop-down in the editor to confirm you are editing the right market. On stores with several markets, a change made for one market does not reach the others, and a market with its own override no longer follows edits to the default. More on this below.
  3. The template. A section added to the default product template does not appear on products that use an alternate template. Open the product in the admin and read its Theme template setting. If one product looks different from the rest, this is the first place to look.
  4. The product or collection itself. Shopify's checks: product Status must be Active, and the product must be published to the Online Store sales channel. A collection that does not show needs the same channel check and a place in your menus.

Last, view the store in a private window. A cached page in your own browser can make a saved change look missing.

Markets and the Context drop-down

Shopify's markets customization page says each market inherits your store's default settings until you add a customization, and removing a customization returns the market to its inherited value. In practice, a section edited for one market stops following the default for that market. If the default looks right and one country's store looks old, remove that market's override rather than editing it again.

Per-market storefront customization is on the Advanced plan and higher, according to Shopify's contextualization page, and needs more than one market (or Shopify B2B) and a theme built with JSON templates. Since 13 March 2026, Shopify's changelog adds theme settings and app embeds to what a market can override, including colours, typography and custom CSS. That means a single app embed can be on for one market and off for another. Our guide to selling internationally on Shopify covers market setup itself.

Colours and settings that will not change have an override above them

When a colour change does nothing, something more specific than the setting you changed is winning. There are three usual candidates: the theme uses a different colour system, the section has its own colour, or custom CSS sets the colour directly.

  • Schemes or palettes. Shopify's colour page says themes manage colour through either colour schemes or colour palettes. Palettes are in newer themes such as Horizon 4.0.0 and later, and changing a palette colour updates every setting that uses it. Schemes are groups of background, text and button colours applied to sections, with up to 21 per theme. Find which system your theme uses under the theme settings icon, then Colors.
  • Section and block settings. Shopify notes that sections and blocks can have their own colour input that overrides the palette. A change at theme level does not touch a section that has its own colour set. Open the section and check its colour setting first.
  • Market overrides. Since March 2026, a market can carry its own colours. Check the Market drop-down before assuming the setting is broken.
  • Custom CSS. CSS added to a section's Custom CSS field or to the theme's stylesheet can set a colour directly, and the editor's colour settings have no control over it. Ask your developer to search the theme for the hex code you are trying to replace.

A colour field left empty can also look like a missing colour. Shopify says deleting the hex code sets a colour to transparent.

When it worked yesterday, look at apps, updates and staff edits

A theme that breaks overnight was usually changed overnight. Three sources account for most of it, and Shopify now gives you a log that shows which one.

Check the Store activity log first

Shopify released a new Store activity log on 13 November 2026. It sits under Settings, then General, then Store activity log, and covers changes to themes, apps, products, staff and store settings, with who made each one: a staff member, a collaborator, an app or Shopify. It keeps up to 18 months, but recording began shortly before that release, so older changes do not appear. Filter by resource, by who made the change and by date range to see who touched the theme. If several people and agencies have access, our guide to giving developers access safely covers how to keep that list short.

Apps

Shopify's apps in themes page describes two ways apps reach your theme. App embeds switch on and off in the editor: open Edit theme, click the App embeds icon in the sidebar, toggle the embed and save. Some apps instead inject code directly into theme files, and those changes stay in the code. To test, duplicate the live theme, switch off embeds one at a time on the copy, and preview it. Shopify's troubleshooting page also suggests temporarily uninstalling recently added or updated storefront apps and contacting the developer if the problem goes away. Our app audit guide covers finding code that uninstalled apps leave behind.

Theme updates

Shopify's theme update page separates two kinds. Automated updates fix bugs or security issues and do not change your content or settings. Manual updates are added as a draft named "Updated copy of" and you publish them yourself. Editor settings carry over, and code edits carry over only if they do not conflict with the update. The theme card then reads either "code edits successfully included" or "code edits could not be included". If it says the second and you publish anyway, your custom code is gone from the live store. Only Theme Store themes get updates: uploaded themes do not, and Shopify has sunset vintage themes, which no longer get updates. If you are weighing a move to a newer theme, our guide on Horizon or Dawn sets out the trade-off.

Roll back safely: duplicate first, and know the limits of file history

The safe fix is to duplicate the live theme, work on the copy, and publish the copy once it works. Shopify's publishing page says that publishing a different theme moves the old one to drafts and loses none of its changes, so switching back is one click.

File history has gaps that matter in an emergency. Shopify's code editing page sets them out:

  • The Timeline view under Edit code restores one file at a time, not a whole theme.
  • It cannot recover deleted files.
  • Files in the assets folder, which hold CSS, JavaScript, images and fonts, have no Timeline history.
  • History is finite, so older versions may be gone.
  • Restoring replaces the whole file, including changes you meant to keep, so copy the current contents somewhere first.

So a broken stylesheet or script cannot be rolled back from Timeline. The only full backup is a duplicate theme made before the change. Keep one dated copy before every release, and remember the library holds up to 20 themes, so delete old copies before you hit the cap during a fix.

Who to call, and when

Once you know the layer, you know who owns the fix. Send them the symptom, the steps you have already tried and the time it started.

LayerWho fixes it
Admin or storefront incident on the status pageShopify. Wait and change nothing
A fresh, updated copy of your theme failsThe theme's developer
An app embed or app code breaks the editorThe app's developer
Your own code edits, a lost update, or a market or template mix-upYour developer or agency
Every theme fails and no app is the causeShopify Support, with your store URL, browser and the steps above

Black Friday falls on 27 November this year. If your theme editor breaks in the final week, fix only what stops sales and leave the rest until after the peak. Our BFCM readiness plan covers the code freeze, and our guide to bug fix turnaround sets out how fast each kind of fault should be fixed.

We look after theme code, releases and rollbacks for D2C stores on retainer through our Shopify maintenance service, with an average reply of 11 minutes on working days. If your editor or storefront is broken now, you can reach us through our contact page.

Questions

Why is my Shopify theme editor not loading?

Most often a browser extension, stale cache or blocked cookies, so open the editor in a private window first. If it still fails on another device and on mobile data, check shopifystatus.com for an Admin incident. If Shopify reports none, add a fresh free theme and open it in the editor. If that loads and yours does not, a code edit or an app attached to your theme is the cause.

Why are my Shopify theme changes not showing on the live site?

The change usually went somewhere you are not looking. Confirm the theme you edited is the live theme and not a draft such as an "Updated copy of" theme. Check the Market drop-down in the editor, because a market with its own override ignores edits to the default. Check the product's Theme template setting, then view the store in a private window to rule out your own cache.

Why does a section show on some products and not others?

The products use different templates. A section added to the default product template does not appear on products assigned an alternate template. Open the product in the Shopify admin, read its Theme template setting, and either add the section to that template or switch the product to the default one. JSON templates allow up to 25 sections each, so a full template can also refuse new sections.

Why are my Shopify theme colours not changing?

Something more specific is overriding the setting you changed. Sections and blocks can carry their own colour, which wins over the theme-wide one. Your theme may use colour palettes (Horizon 4.0.0 and later) rather than colour schemes, so you may be editing the wrong system. A market can also have its own colours since March 2026, and custom CSS can set a colour the editor never controls.

What does "HTML error found" mean in the Shopify theme editor?

Shopify shows it when the theme's code has a problem, usually invalid Liquid or broken HTML in an included snippet, and the warning names the Liquid file at fault. Open Online Store, then Themes, then Edit code, find that file, and fix or restore it from the Timeline view. Copy the current contents first, because restoring replaces the whole file. Then open the editor again.

Can I undo changes to my Shopify theme?

Partly. The Timeline view in the code editor restores one theme file at a time, and only for code files. It cannot recover deleted files, keeps no history for assets such as CSS and JavaScript, and older versions may be gone. The reliable undo is a duplicate of the theme made before the change, which you can publish again in one click.

Will a Shopify theme update break my customizations?

Editor settings carry over, and code edits carry over only if they do not conflict with the update. Manual updates arrive as an unpublished draft, and the theme card says whether code edits were included. If it says they could not be included, copy your custom code into the new version before publishing. Uploaded themes and vintage themes receive no updates from Shopify.

Get started

Talk to us about your store.

Average reply 11 min

Book a call

30 minutes with Suvam. Leave knowing what to fix, build or leave alone.

Book a call
Mon to Sat, 9 to 23 IST

Email us

A brief, a bug or a question. All welcome.

suvam@knox.team