shopify-developer

Provides reference guidance for Shopify theme, app, Liquid, GraphQL, and Hydrogen development.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Peterson-Benhame/agent-skills --skill shopify-developer-peterson-benhame
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-developer
Source: https://github.com/Peterson-Benhame/agent-skills/tree/main/packages/skills-catalog/skills/%28development%29/shopify-developer
Command: npx skills add https://github.com/Peterson-Benhame/agent-skills --skill shopify-developer-peterson-benhame

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Shopify development spans Liquid templating, GraphQL Admin and Storefront APIs, OS 2.0 themes, Functions, and Hydrogen, and keeping track of syntax, deprecations, and best practices across all of them is error-prone. This Skill consolidates the full Shopify development surface (API version 2026-01) into one navigable reference. ## Core Features & Use Cases - Liquid Templating Reference: Covers tags, filters, objects, control flow, and LiquidDoc for writing and debugging .liquid files. - API Integration Guides: Documents GraphQL Admin API, Storefront API, Ajax cart API, OAuth, webhooks, and rate limiting with working code examples. - App, Functions & Hydrogen Coverage: Explains Shopify CLI workflows, app extensions, Polaris components, Scripts-to-Functions migration, and headless storefronts with React Router 7. - Use Case: When a Liquid template throws an undefined variable error on a collection page, consult the debugging reference to identify the nil-check pattern and fix the template. ## Quick Start Ask the agent to help you build or debug a Shopify theme section, write a GraphQL Admin query, or migrate a Shopify Script to a Function.

Frequently Asked Questions about shopify-developer

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

FAQPage Schema
How do I write GraphQL queries for the Shopify Admin API?

Send a POST request to https://{store}.myshopify.com/admin/api/2026-01/graphql.json with an X-Shopify-Access-Token header and a JSON body containing your query and variables. Always check the errors array in the response before accessing data, and prefer GraphQL over the legacy REST API.

How do I migrate from Shopify Scripts to Shopify Functions?

Identify each Script in use, map it to a Function type such as product_discounts or payment_customization, then rewrite the logic in Rust or JavaScript compiled to WebAssembly. Test locally with shopify app function run, deploy with shopify app deploy, and disable the old Scripts.

Should I use GraphQL or REST for the Shopify Admin API?

GraphQL is Shopify's primary Admin API and should be used for all new development. The REST Admin API remains available but is under active deprecation, receives fewer updates, and is less efficient for fetching nested data.

Why is my Liquid template showing an undefined variable error?

The error occurs when accessing an object that is nil in the current context, such as product on a collection page. Wrap the output in an {% if product %} check or use the default filter to provide a fallback value.

Does Hydrogen still use Remix for routing?

No. Since Hydrogen 2025.5.0, Hydrogen uses React Router 7 instead of Remix for file-based routing, loaders, and actions. Existing Remix-based projects should plan a migration, while new projects default to React Router 7 templates.

How do I handle Shopify API rate limits?

The GraphQL Admin API uses a points-based limit of 50 cost points per second. Monitor the X-Shopify-GraphQL-Admin-Api-Call-Limit header, and on HTTP 429 responses implement retry logic with exponential backoff using the Retry-After header.