Diff two stores
diff_storesCompare configuration between two Shopify stores or snapshots by resource type, returning counts, changed keys, and before/after values without writing anything.
Instructions
Compare configuration between a source and a target, resource type by resource type. Returns for each type the counts (onlyInSource, changed, onlyInTarget, identical) and the keys in each section, with before and after values for every changed field (show_values=false keeps only the field paths); limit caps each list while the counts cover everything, and format="markdown" gives a report to share. Either side can be a snapshot folder ("dir:"), e.g. to check whether production drifted from the committed config. The options shared with plan_sync (resources, include, prices, inventory, as_drafts...) only decide what is read and compared, so the diff matches the plan the same options would produce; nothing is written. Use compare_item for a single item, diff_themes for theme settings, and plan_sync to prepare the changes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"source": "<source>",
"target": "<target>"
},
"name": "diff_stores"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max items listed per section (default 100, markdown 50). The counts always cover everything. | |
| format | No | "markdown" returns a report to paste into a ticket or an email. | |
| prices | No | products: include variant prices and compare-at prices in what is read, compared and planned. Off by default, since prices usually differ per store. | |
| source | Yes | Store alias, or "dir:<path>" for a snapshot folder made with export_snapshot. | |
| target | Yes | Store alias, or "dir:<path>" for a snapshot folder made with export_snapshot. | |
| exclude | No | Drop keys matching any of these globs. | |
| include | No | Only keys matching one of these globs, e.g. ["PRODUCT.custom.*", "faq/*", "fr:*"]. | |
| locales | No | Limit translations to these locales, e.g. ["fr", "de"]. Default: every non-primary locale. | |
| as_drafts | No | Leave the published state out of what is compared and copied: in a plan, new pages are created hidden and new metaobject entries as drafts, and existing ones keep their state. Products are always created as drafts. | |
| inventory | No | products: include stock (the available quantity per location, matched to the target's location with the same name) in what is read, compared and planned. Off by default. Needs read_inventory and read_locations, plus write_inventory to apply: run connect again if the sign-in is older. | |
| resources | No | Resource types to include. Default: metafield_definitions, metaobject_definitions, collections, pages, shop_policies, metaobjects, menus, redirects. products, metafields and translations are opt-in. | |
| namespaces | No | Limit metafield values (metafields) to these namespaces. | |
| owner_types | No | Metafield owner types. For metafield_definitions, default: PRODUCT, PRODUCTVARIANT, COLLECTION, CUSTOMER, ORDER, DRAFTORDER, COMPANY, COMPANY_LOCATION, LOCATION, MARKET, PAGE, BLOG, ARTICLE, SHOP. For metafield values (metafields): PRODUCT, COLLECTION, PRODUCTVARIANT, SHOP (all by default). | |
| show_values | No | Include before/after values for each changed field (default true). | |
| include_reserved | No | metafield_definitions: also compare Shopify-reserved ones (namespace "shopify", the category metafields that drive storefront filters). Compared only: a plan reports them as conflicts and never writes them. | |
| metaobject_types | No | Limit metaobjects to these types. Default: all non-reserved types. |