shopify-debugging

Diagnose Shopify Liquid, JavaScript, API, and webhook errors.

322|45|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/Microck/ordinary-claude-skills --skill shopify-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-debugging
Source: https://github.com/Microck/ordinary-claude-skills/tree/main/skills_all/shopify-debugging
Command: npx skills add https://github.com/Microck/ordinary-claude-skills --skill shopify-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides debugging guidance for Shopify themes, apps, GraphQL/REST APIs, and related frontend logic.

Core Features & Use Cases

  • Liquid syntax and rendering debugging
  • API error handling, JavaScript debugging, and webhook troubleshooting

Quick Start

Debug a Liquid template error by inspecting the browser console and API responses.

Frequently Asked Questions about shopify-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug Liquid template errors in Shopify themes?

Debugging Liquid template errors involves inspecting browser console output, checking theme logs, and validating Liquid syntax in your templates. Identify where rendering fails by reviewing error messages, then correct syntax issues or variable assignments in your Liquid code to resolve the problem.

Why are my Shopify API requests failing and how do I fix them?

Shopify API request failures stem from authentication errors, malformed GraphQL/REST queries, rate limiting, or incorrect endpoint URLs. Debug by inspecting API response codes and error messages, validating your request structure against Shopify's schema, and confirming your access token permissions.

How can I troubleshoot Shopify webhook delivery failures?

Webhook delivery failures occur from incorrect endpoint configuration, network timeouts, or payload validation issues. Diagnose by checking webhook logs in your Shopify admin, verifying your endpoint receives and processes the correct payload format, and confirming your server responds with a 2xx status code.

What's the best way to debug JavaScript errors in Shopify checkout and cart?

Debug JavaScript errors by opening browser developer tools to inspect console logs and network requests, identifying which scripts fail and why. Check for syntax errors, missing dependencies, or conflicting scripts, then validate your fixes against the checkout flow in a test environment.

Can I debug Shopify theme rendering issues across different browsers?

Yes, Shopify theme rendering issues often vary by browser due to CSS or JavaScript compatibility. Debug by testing your theme in multiple browsers, inspecting console errors specific to each, and identifying whether the problem stems from Liquid output, CSS, or JavaScript behavior.

How do I locate and fix errors in Shopify app integrations?

Locate app integration errors by reviewing API logs, webhook delivery records, and client-side console errors. Correct issues by validating your API calls match Shopify's requirements, ensuring webhooks are properly configured, and testing your app flow end-to-end before deployment.