PatchVault › Errors › Shopify CLI 5 migration

shopify theme dev --poll

Scripts that still pass --poll to theme dev break after upgrading to Shopify CLI 5.0, which removes the flag.

Check your code free (runs in your browser)

The box is pre-filled with a sample that triggers this error. Paste your own file to check it. Nothing leaves this page.

Or scan your whole repo locally (free, stdlib Python, read-only):

python3 <(curl -fsSL https://patchvault-81y.pages.dev/starters/shopify-cli-scan.py) .
Get the Shopify CLI 5 migration auto-fixer: $9 one-time

Why it happens

Per Shopify's migration guide, --poll has been deprecated since 3.61.0 and has had no effect since 3.70.0, so no replacement is needed.

Manual fix

# before
shopify theme dev --store my-store --poll
# after (5.0)
shopify theme dev --store my-store

Verify

Re-run your install/build and re-scan the file above. The finding should be gone. The paid fixer applies the same change across a repo: --dry-run shows the diff, --apply keeps a .bak of each file, and --rollback restores them.

Sources

Related errors

Full guide and free terminal scanner: Shopify CLI 5 migration. Last checked 2026-10-31.