Updating a Customised Shopify Theme Without Breaking It

Most Shopify stores are running a theme that has been customised, then left alone. The update notice appears in the admin, nobody is sure what will break, and the store stays on a version that is two years old. That is a fair worry, because a theme update does not treat every part of your store the same way. This guide explains what actually happens, and how to update without losing your work.

It is written for store owners and ecommerce managers on Shopify who have paid for theme customisation at some point, and who are now sitting on an update they have not applied.

What actually happens when a Shopify theme updates?

The update does not overwrite your live theme. Shopify's documentation on updating themes describes the process: you click the update notice and add the updated version to your draft themes. Your published theme keeps running until you choose to publish the new one.

What carries over is where store owners get surprised. According to that same Shopify page:

• Theme editor work carries over. Settings, sections, layout changes and templates you created in the theme editor are copied to the updated theme.
• Code edits carry over only when they do not conflict. Where they do conflict, Shopify shows a message saying the theme was added but code edits could not be included, and those edits have to be reapplied by hand.
• Automated updates are limited to fixes. Shopify describes them as updates that fix bugs or security issues and that do not change the look and feel of the theme, your content or your settings.
• Only Theme Store themes get updates. Themes installed from the Shopify Theme Store can be updated. Themes bought elsewhere or uploaded as files cannot be updated this way, and vintage themes are no longer updated by Shopify.

So the question is never "will the update break my store". It is "how much of my custom code conflicts, and who reapplies it".

How do you know how customised your theme really is?

Before touching an update, find out what has been changed and by whom. Three quick checks, none of which need a developer:

1. Look at the theme name and version. In Online Store, then Themes, your live theme shows its name and version. If the name includes words like copy, final, backup or a developer's name, the theme has been worked on outside the theme editor.
2. Count your theme library. Stores that have been through several developers collect old copies. Note which one is published and when each other one was last touched.
3. Ask which apps injected code. Review apps, upsell apps, popups and tracking tools often add snippets to theme files. Apps you removed months ago sometimes leave their code behind.

Write the list down before you start. It becomes the checklist you test against after the update. If you have never reviewed which apps are still touching your theme, our guide to auditing your Shopify app stack is a good companion to this one.

Why did my theme colours change after an update?

This one has a specific and recent cause. On 17 June 2026, Shopify introduced a new color palette setting for themes, a single grid of colours that applies across the whole theme, with Horizon version 4.0.0 and later using it. Shopify's note is clear that existing colour schemes continue to work and that palettes are not required, but a theme that moves to a version built around palettes handles colour differently from the version you customised.

That is exactly the kind of change that makes a preview worth the time. Colour, type scale and spacing changes do not break a store, but they do change how it looks, and you want to see that on a draft rather than discover it live.

Should you update the theme or move to a new one?

Update when the theme you have still fits the store and the customisations are modest. Move to a new theme when you are fighting the theme to do ordinary things, or when the theme is no longer supported.

Shopify's free Horizon themes, announced on the Shopify changelog, are built with theme blocks, which give merchants more control over sections without a developer. If your current theme is a vintage theme with no updates available, or a marketplace theme whose developer has gone quiet, a move to a supported theme is usually the better investment. The customisation work gets rebuilt once on a base that will keep receiving updates.

Signs that point to a move rather than an update:

• the theme is vintage, or shows no update option at all
• small changes always need code, because the sections have no settings
• the theme came from a developer as a file, so it cannot be updated from the Theme Store
• page speed problems trace back to the theme itself rather than to apps
• the design no longer matches how the brand sells today

If a move is where you land, our Shopify store redesign guide covers how to scope that properly, and our breakdown of theme customisation costs in India explains what drives the price of rebuilding custom sections.

What is the safe order for updating a customised theme?

Five steps, in this order.

1. Record the current state. Download the published theme file so you have a copy of the exact code that is running today. Note the theme name, version and publish date.

2. Add the update as a draft. Use the update notice in the admin. Shopify adds the new version to your draft themes, and nothing on the live store changes.

3. Read the code edits message carefully. If Shopify reports that code edits could not be included, that is your work list. Those edits are the custom sections, snippets and app code that need to be reapplied to the new version.

4. Preview everything, on a phone. Home, collection, product, cart, checkout entry, search, blog, account pages and any landing page that matters. Check a product that is out of stock, one on sale, and one with a long name. Place a test order through the preview if your setup allows it.

5. Publish, and keep the old theme. Publish the updated theme, then leave the previous version in your theme library. If something surfaces the next day, switching back takes seconds.

What breaks most often after a theme update?

The pattern is consistent, and it is nearly always custom code rather than Shopify's own theme code:

• App snippets. Review widgets, size charts, upsell blocks and trust badges that were added into theme files rather than through an app block.
• Custom sections. Sections a developer built for your brand, which the update knows nothing about.
• Tracking code. Pixels and analytics tags pasted into theme.liquid, which can quietly stop firing.
• Cart and checkout entry points. Custom cart drawers, quantity rules and free shipping bars.
• Language and currency. Custom wording in buttons and notices, which returns to theme defaults.

Check tracking specifically, because it fails silently. A store can run for weeks with broken conversion tracking before anyone notices the numbers look wrong.

How often should a Shopify theme be updated?

There is no schedule that suits every store. A reasonable approach is to apply security and bug fix updates when Shopify offers them, since Shopify states these do not change your look, settings or content, and to plan larger version updates deliberately, at a quiet time of year rather than during a sale or festive season.

What matters more than frequency is knowing what is custom in your theme. A store with a documented list of its customisations can update in an afternoon. A store where nobody knows what was changed, or by whom, turns every update into an investigation. If you recently changed developers, or are about to, our developer handover checklist covers how to get that documentation while you still can.

Can you update a theme yourself, or do you need a developer?

If your theme came from the Theme Store, has no custom sections, and Shopify reports no conflicting code edits, most store owners can do it themselves by following the steps above. The draft and preview flow is designed for exactly that.

Bring in a developer when Shopify reports code edits that could not be included, when your theme has custom sections built for your brand, when apps have written code into your theme files, or when the store carries enough daily revenue that an hour of broken checkout is expensive. In those cases the update is not one click, it is a small project with a test plan.

Want your theme update reviewed before you publish it?

We work on Shopify themes that other people customised, which is usually where these questions come from.

Free review. Get in touch or email hello@exactwhy.com with the subject "Theme update", and tell us which theme you run and what Shopify reported about your code edits. We reply within 4 hours with what is safe to click and what needs a developer first.

Update work. If you want us to handle it, we reapply the customisations to the updated theme, test every page type and both common phone sizes, and publish only once you have seen the preview yourself.