How to compare two Shopify themes, file by file

29 July 2026 · 6 min read

"It works on the staging theme but not on the live one" is a sentence that costs hours, because the obvious next question — what is actually different? — has no button in the admin. There is no way to compare two Shopify themes there: no diff view, no side-by-side, no list of files that differ. You have to go and find out.

Here are the ways to compare two Shopify themes that actually work, cheapest first.

1. By eye in the code editor

Open Online Store → Themes → ⋯ → Edit code for both themes in two browser tabs, navigate to the same path in each, and read. Fine when you already know which file is suspect. Useless when you do not, which is most of the time — a theme has hundreds of files and you cannot read them all.

One thing this does give you cheaply: the file list itself. If one theme has a snippet the other does not, you will see it in the sidebar without reading a single line.

2. Pull both themes locally and diff them

If you have the Shopify CLI, this is the thorough option:

1. Run shopify theme pull for the first theme into its own folder.
2. Run it again for the second theme into a second folder.
3. Compare the folders with diff -r, your editor's folder-compare, or a dedicated diff tool.

You get an exact answer including files that exist on one side only. The costs are real though: it needs CLI access and store permissions, it takes minutes rather than seconds, and it produces noise — themes differ in generated or reordered content that is not the change you are hunting.

3. Compare inside the admin with a tool that does it for you

The reason this problem keeps coming back is that comparison is not a one-off task. Every theme update, every app install, every handover produces the same question, and re-running a manual pull-and-diff each time is why people stop bothering and start guessing.

Auto Theme Sync compares any two themes file by file inside the Shopify admin and shows a colour-coded diff of what changed — added, removed and modified lines — without leaving the browser or installing anything locally.

What to look at first when comparing Shopify themes

Whichever method you use, the differences that explain most breakage cluster in a few places:

• config/settings_data.json — theme settings. A "code" difference is often really a settings difference.
• templates/*.json — section order and per-section settings for OS 2.0 themes.
• snippets/ — small shared partials, where a one-line change breaks several pages at once.
• layout/theme.liquid — script tags and app embeds land here.
• assets/ — a stale compiled CSS or JS file explains a lot of "it looks wrong but the Liquid is identical".

A difference is not automatically the cause. Check the file's timestamp and whether the change lines up with when the problem appeared, before you revert anything.

Why two themes differ when nobody changed anything

Plenty of differences are not somebody's edit, and knowing which is which saves you chasing ghosts:

• Apps write into the theme on install and sometimes on update, usually in theme.liquid or a dedicated snippet.
• The theme editor rewrites settings and template JSON whenever anyone saves, even if nothing visibly changed.
• Duplicating a theme does not carry across everything an app stored outside the theme, so the copy can behave differently with identical files.
• Vendor updates change files you never touched, which is expected and is the reason the update exists.

The practical filter: compare against a copy of the same theme from a known-good moment rather than against a different theme. Then every difference is a change over time, not a difference between two things that were never identical.

After you find it

Once you know which file differs, you need the old content back — which is a different problem, covered in how to restore a theme file you overwrote. And if you had a dated copy of the theme from before the change, the comparison would have been against a known-good state rather than against another theme you are also unsure about: see the complete guide to theme backups.

Keep reading

Shopify staging theme: a workflow that does not lose work
How to run a Shopify staging theme properly — where to make changes, how to move them live, and how to avoid the drift that makes staging useless.

Shopify theme version control: what agencies actually use
Shopify keeps no file history of its own. The real options for Shopify theme version control: Git, the GitHub integration, CLI pulls, automatic capture.