shopify-advanced-troubleshooting

Featured

Debug complex Shopify API issues using cost analysis, request tracing, webhook delivery inspection, and GraphQL introspection. Trigger with phrases like "shopify hard bug", "shopify mystery error", "shopify deep debug", "difficult shopify issue", "shopify intermittent failure".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Shopify Advanced Troubleshooting ## Overview Deep debugging for complex Shopify API issues: cost analysis with debug headers, webhook delivery inspection, GraphQL query introspection, and systematic isolation of intermittent failures. ## Prerequisites - Access to Shopify admin and Partner Dashboard - Familiarity with GraphQL and HTTP debugging - `curl` and `jq` available ## Instructions ### Step 1: GraphQL Cost Analysis When queries THROTTLE unexpectedly, use the cost debug header: ```bash # Get detailed per-field cost breakdown curl -X POST "https://$STORE/admin/api/2024-10/graphql.json" \ -H "X-Shopify-Access-Token: $TOKEN" \ -H "Content-Type: application/json" \ -H "Shopify-GraphQL-Cost-Debug: 1" \ -d '{ "query": "{ products(first: 50) { edges { node { id title variants(first: 20) { edges { node { id price metafields(first: 5) { edges { node { key value } } } } } } } } } }" }' | jq '.extensions.cost' ``` Response shows why the cost is high: ```json { "requestedQueryCost": 1552, "actualQueryCost": 234, "throttleStatus": { "maximumAvailable": 1000.0, "currentlyAvailable": 766.0, "restoreRate": 50.0 } } ``` **Key:** `requestedQueryCost` is `first` multiplied through nested connections. `50 products * 20 variants * (1 + 5 metafields)` = high cost even if actual data is small. ### Step 2: Trace a Specific Request Every Shopify response includes `X-Request-Id`. Capture it for support: ```bash # Capture full response headers and bo...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category