For the complete documentation index, see llms.txt. This page is also available as Markdown.

Understanding your update summary

What the update summary shows, and how to choose your way forward.

After the app merges your theme with the new version, it shows the result as an update summary: what carried over on its own, what needs your attention, and how to proceed. You can leave this screen and come back anytime — your progress is saved for the entire 30-day update window.

What the summary shows depends on what the merge found.

If nothing conflicts: ready to finish

When every customization carried over automatically, the summary says so — there are no decisions to make. Preview the theme to check that everything looks right, then finish the update.

Right after the merge, Preview theme and Finish update stay disabled for a short while — the app is adding the preview theme to your Online Store. They become available as soon as it's ready.

Files with conflicts

Files where your customizations and the new theme version changed the same code. Each conflict needs your decision, and the summary offers three ways to make them:

  • Apply new theme changes — the fastest option. Your customizations are already applied everywhere they could be; in the remaining conflict areas, the new version's code is used.

  • Review conflicts manually — go through each conflict and decide what to keep. You only see the places that need your attention — everything else is already resolved. See Resolving conflicts.

  • Get expert help — the Staylime team completes the update for you at a fixed price. See Get expert help.

Once every conflict is resolved, the section is renamed to Files with resolved conflicts.

Files marked "Blocks preview". In these files, the code has diverged too much for the theme to be assembled until their conflicts are decided — so Preview theme, Finish update, and Apply new theme changes stay unavailable until you resolve them. If several files carry this badge, you're looking at a heavy update: a good moment to consider Get expert help.

Files with customizations not present in the updated version

This section appears only when the update runs into it: files you customized that the new theme version no longer includes. The vendor restructured the theme, so there is nothing to merge these files with. They are kept in your updated theme untouched — but the new version may no longer load them, so their effect can quietly disappear.

After the update, check the storefront pages these files affected — especially the ones you customized heavily. If a customization from one of these files matters to you, it needs to be re-applied in the new version's structure: see When conflicts get hard for your options, including Get expert help.

Successfully updated files with customizations

Files where your customizations were carried over automatically, with no overlaps. Nothing to do here — the list exists so you can see exactly what moved. It also includes files you added to the theme yourself (such as robots.txt.liquid): they are carried over as-is.

Some files couldn't be prepared for update

A red banner that can appear while you work through conflicts: during the merge, some files developed structural issues that Shopify would reject, and Preview theme and Finish update are unavailable until they're fixed. The Fix rejected files button opens a screen built for exactly this — see Fixing rejected files.


Once every conflict is resolved and any rejected files are fixed, the update is ready to finish: preview the result, then finish the update.

Whatever the summary shows along the way, your live theme stays untouched: you can cancel the update at any point, and nothing is published until you decide.

Last updated

Was this helpful?