Shopify CLI 3.x to 5 migration

Shopify CLI 5 Migration Fix: score your repo in 10 seconds

Shopify CLI 5 breaks your theme and app scripts on upgrade. Paste your package.json and see every breaking flag in 10 seconds, free.

Paste package.json or a CI script. Get a Readiness Score out of 100 and every breaking flag, free. The fix bundle rewrites them for you.

✓ Runs 100% in your browser✓ Free score, no signup✓ Instant download after checkout✓ Free terminal scanner

🕹️ Try It Right Now in Your Browser

A realistic broken sample is preloaded. Nothing is uploaded: the scan runs in this tab.

$python3 <(curl -sL https://thorp-tools.pages.dev/starters/shopify-cli-scan.py)

Or scan your whole repo from the terminal (Python 3, stdlib only, reads files locally).

Before: CI fails after the CLI 5 upgrade
"@shopify/cli": "^3.58.0"
shopify theme push --theme-editor-sync
node 18 in CI
After: builds on CLI 5
"@shopify/cli": "^5.0.0"
shopify theme push
node 20.10+ in CI
$29$9one-time, no subscription. 10-second fix bundle. Get the fix bundle

100% Working Patch Guarantee — full refund if it doesn't pass your build check
Refund requests: open a Discussion at thorp-tools.pages.dev

The math: A broken theme deploy costs a freelancer at $75/h about 2 hours of flag hunting, roughly $150. The bundle is $9 and the scan takes 10 seconds.

Key Takeaways

  • Shopify CLI 5 needs Node 20.10+ and drops several 3.x flags; old CI scripts fail on upgrade.
  • The free checker flags each affected line in your package.json, shopify.app.toml or CI script.
  • The $9 bundle ships the codemod, CI templates and a step checklist so the upgrade passes on the first run.

Free instant diagnostic: your Readiness Score

What the $9 bundle contains

  • CLI codemod that rewrites removed flags and engine pins
  • AI repair prompts for edge cases
  • CI checklist for GitHub Actions and Bitbucket
  • Before/after examples

Who this is NOT for

  • Teams with a dedicated platform engineer who already scripted this migration
  • Anyone who enjoys reading changelogs line by line
  • Repos that the free score already rates 100/100

Shopify CLI 5 fix: this bundle vs doing it by hand

This toolManual / ChatGPT
Finds every issueYes, file and lineMisses files you did not paste
TimeAbout 10 seconds1 to 3 hours
CostOne-time feeYour hourly rate
Runs offlineYesNo

Run Free 10-Second Terminal Scan

Paste this in your project folder. One Python 3 file, standard library only, nothing is uploaded. It checks for Shopify CLI 5 breaking flags, tokens and JSON changes and prints a 0-100 score.

python3 <(curl -sL https://thorp-tools.pages.dev/starters/shopify-cli-scan.py) .
View the script

Shopify CLI 5: which option is best suited for you

OptionBest Suited ForCost
Free checker on this pageSeeing what breaks before you upgradeFree
$9 fix bundleTeams who want the codemod, CI templates and checklist done for them$9 one-time
Shopify's upgrade guide by handSmall repos with one script and time to read the changelogFree, 1-3 hours
Pinning the old CLIStores that must ship today and upgrade laterFree, but builds up debt

⚡ Building a dev tool? Get featured in our comparison table & GitHub Wiki ($49) →

Exact errors this fixes

Error: Unknown flag --theme-editor-sync

The flag was removed in CLI 5. The codemod drops it and adds the replacement step.

The engine "node" is incompatible with this module

CLI 5 needs Node 20.10+. The bundle bumps engines and your CI node-version.

Shopify CLI 5.0 migration checker

Shopify CLI 5.0.0 shipped on Oct 27, 2026 with breaking changes: app logs removed, theme dev --poll removed, new JSON output contracts for theme, Functions, store execute, config validation and subscription migrations, and a new SHOPIFY_SERVICE_ACCOUNT_TOKEN. Paste any mix of package.json, GitHub Actions YAML, shell scripts, Makefiles, JS that parses CLI output, or shopify.app.toml. Nothing leaves your browser.

Fix it automatically: Shopify CLI 5.0 10-Second Fix Bundle — $9
Node CLI that scans your whole repo (package.json, CI YAML, shell, JS/TS, TOML), applies the safe codemods with --fix (version bump from 4.x, --poll removal, .themes[] jq rewrite, token rename, --no-watch, snake_case log payloads) with .bak backups, a --ci gate, a Markdown report, and a 20-step checklist. Instant download after checkout.

Get the Migration Pack $9

Rules are built from the official 5.0.0 release notes and migration guide. Not affiliated with Shopify. Always verify with shopify <command> --json-schema.

Methodology

The free checker runs entirely in your browser: it matches the text you paste against rules written from the official changelogs and migration guides. Nothing is uploaded. The paid deliverables are files (codemod, templates, checklist) unlocked right after checkout; each pack is tested against the fixtures shipped inside it.

Sources and free assets: GitHub release · GitHub Wiki guide. Contact and support: open a Discussion at thorp-tools.pages.dev.

Last Updated:

FAQ

What breaks in Shopify CLI 5.0?

Removed commands such as app logs, removed flags such as theme dev --poll, renamed SHOPIFY_*_TOKEN variables and new --json output shapes for theme and app commands.

Is the checker free?

Yes. The web checker, the CLI scanner and the MCP server are free and read-only. The $9 Pro pack adds auto-fix codemods, CI templates and a full checklist.

Does my code leave the browser?

No. The scan runs entirely in your browser.

Free starter files: GitHub Releases