shopify-common-errors

Featured

Diagnose and fix common Shopify API errors including 401, 403, 422, 429, and GraphQL errors. Use when encountering Shopify errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "shopify error", "fix shopify", "shopify not working", "debug shopify", "shopify 422".

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 Common Errors ## Overview Quick-reference guide for the most common Shopify API errors with real error messages, causes, and fixes. ## Prerequisites - Shopify app with API credentials configured - Access to application logs or console output ## Instructions ### Step 1: Identify the Error Type Check whether the error is an HTTP status code error or a GraphQL `userErrors` response. ### Step 2: Match Error Below and Apply Fix --- ### 401 Unauthorized **Actual Shopify Response:** ```json { "errors": "[API] Invalid API key or access token (unrecognized login or wrong password)" } ``` **Causes:** - Access token expired (merchant uninstalled and reinstalled) - Wrong `X-Shopify-Access-Token` header - Using a Storefront API token for Admin API or vice versa **Fix:** ```bash # Verify token format: # Admin API token: shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (32 hex chars) # Storefront API token: different format, starts with shpat_ too curl -s -o /dev/null -w "%{http_code}" \ -H "X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN" \ "https://your-store.myshopify.com/admin/api/2024-10/shop.json" # Should return 200 ``` --- ### 403 Forbidden **Actual Shopify Response:** ```json { "errors": "This action requires merchant approval for read_orders scope." } ``` **Cause:** Your app's access token lacks the required scope. **Fix:** Add the needed scope to your app config and re-trigger OAuth: ```toml # shopify.app.toml [access_scopes] scopes = "read_products,write_...

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