Compare theme settings
diff_themesCompare Shopify theme configuration between two stores, including JSON templates, section groups, and settings_data.json, to identify changed files and differing settings for review.
Instructions
Compare theme configuration between two stores: JSON templates, section groups and settings_data.json (default files: templates/.json, sections/.json, config/settings_data.json). Use it for theme settings; use diff_stores for store data such as metafields, metaobjects and pages. Compares the published themes unless source_theme or target_theme give theme ids. Returns file counts (onlyInSource, changed, onlyInTarget, identical), the files on one side only, and for each changed file the settings that differ with both values (first 100 per file); format="markdown" gives a report. Use ignore_settings to quiet settings that differ on purpose. Never writes to a theme; both stores need the read_themes scope.
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_themes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | Theme file patterns, e.g. ["templates/product*.json"] | |
| format | No | "markdown" returns a report to paste into a ticket or an email. | |
| source | Yes | Store alias to compare from (snapshot folders hold no themes). | |
| target | Yes | Store alias to compare with. | |
| exclude | No | Theme file patterns to leave out, e.g. ["templates/gift_card.json"]. | |
| source_theme | No | "main" (default) or a theme id | |
| target_theme | No | "main" (default) or a theme id | |
| ignore_settings | No | Settings to leave out, as globs on their path, optionally limited to files: ["current.sections.header.*", "config/settings_data.json:current.color_*"]. Use it to quiet settings that differ on purpose between stores. |