sincecutoff.com
/v1/json /v1/md llms.txt
← all changes

shopify theme dev adds JSON reconciliation strategy

Introduced 2026-07-31 · score 0.96

HOW TO USE IT

When `shopify theme dev` is run with `--theme-editor-sync` and JSON files conflict, set `--reconciliation-strategy` to `keep-local`, `keep-remote`, or `abort`.

shopify theme dev --theme-editor-sync --reconciliation-strategy keep-local
shopify theme dev --theme-editor-sync --reconciliation-strategy keep-remote
shopify theme dev --theme-editor-sync --reconciliation-strategy abort

WHY THIS HELPS

Run theme editor sync when local and remote JSON theme files conflict in automation.

BEFORE THIS CHANGE

With `--theme-editor-sync`, conflicts could prompt for a reconciliation strategy; the release note says this change makes the strategy configurable to resolve that prompt in automation.

REQUIREMENTS AND LIMITATIONS

  • Version: 4.6.0
  • --theme-editor-sync: Synchronizes Theme Editor updates in local theme files; reconciliation strategy applies when this flag is enabled.
  • --reconciliation-strategy: Chooses how to resolve JSON conflicts when `--theme-editor-sync` is enabled. Allowed values: `keep-local`, `keep-remote`, `abort`. The docs do not state these values are mutually exclusive.
  • SHOPIFY_FLAG_RECONCILIATION_STRATEGY: Environment variable for `--reconciliation-strategy`.
  • Prerequisite: Run the command from a directory matching the default Shopify theme folder structure.
  • The strategy applies when `--theme-editor-sync` is enabled.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card