Complete debugging and troubleshooting guide for Shopify including Liquid errors, theme preview debugging, API error handling, JavaScript console debugging, network request inspection, cart issues, checkout problems, and common error codes.
NewMaintained
Automatic
◆Frontend / UI pack
Last verified 8/21/2026
What it changes
Passed 21 of 22 test cases with the skill, and 21 of 22 without it.
Without skill95%
With skill95%
Checks it passed that the model alone missed
Read the X-Shopify-GraphQL-Admin-Api-Call-Limit response header
1 fixed20 passed either way0 still failing1 broke
Pass-rate lift
0 pp
Tokens
+282%
Agent turns
0%
Response time
-18%
Model gemini-3.6-flashMeasured 8/21/2026v121 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
A test case the skill fixed. Same model, same prompt, with and without the skill.
Prompt
Our backend service executes queries against the Shopify Admin GraphQL API. We need to monitor our remaining query credit budget from HTTP response headers to avoid status 429 throttling. Which HTTP header provides the Admin GraphQL call limit usage?
What was checked, without and with the skill
Checked
Without skill
With skill
Read the X-Shopify-GraphQL-Admin-Api-Call-Limit response header
Missed
Passed
case-08 · gemini-3.6-flash · 8/21/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md700 linessingle file
Shopify Debugging & Troubleshooting
Expert guidance for debugging Shopify themes, apps, and API integrations with practical solutions to common issues.
When to Use This Skill
Invoke this skill when:
Debugging Liquid template errors or syntax issues
Troubleshooting theme rendering problems
Fixing API errors (GraphQL, REST)
Debugging JavaScript errors in themes or apps
Investigating cart or checkout issues
Resolving webhook delivery failures
Troubleshooting OAuth authentication problems
Debugging theme preview or customizer issues
Investigating slow page loads or performance problems
Fixing metafield or metaobject access errors
Resolving CORS or network request issues
Core Capabilities
1. Liquid Debugging
Debug Liquid template errors and rendering issues.
Enable Theme Preview:
1. Go to Online Store > Themes
2. Click "Customize" on your theme
3. Open browser DevTools (F12)
4. Check Console for Liquid errors
Common Liquid Errors:
Syntax Error:
{# ❌ Error: Missing endif #}
{% if product.available %}