shopify-graphql-reference

Align Shopify GraphQL queries, fragments, and cache rules with the live Storefront schema.

45|12|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/vercel/shop --skill shopify-graphql-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-graphql-reference
Source: https://github.com/vercel/shop/tree/main/packages/plugin/skills/shopify-graphql-reference
Command: npx skills add https://github.com/vercel/shop --skill shopify-graphql-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This guide solves the challenge of keeping GraphQL queries, fragments, and caching aligned with Shopify's live Storefront schema across the template.

Core Features & Use Cases

  • Pattern alignment: Maintain consistent operation structures and fragments across queries and mutations, aligned with the live schema.
  • Guardrails and troubleshooting: Enforce locale context, cache rules, and transforms to reduce errors and drift.
  • Use case: When building, debugging, or extending Shopify GraphQL work in the template, refer to canonical references to ensure correctness.

Quick Start

Consult the Shopify GraphQL reference to align queries, fragments, and cache rules with the live Storefront schema.

Frequently Asked Questions about shopify-graphql-reference

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

FAQPage Schema
How do I align Shopify GraphQL queries with the live Storefront schema?

To align Shopify GraphQL queries with the live Storefront schema, consult canonical references to maintain consistent operation structures and fragments across queries and mutations for consistent storefront development.

What's the best way to enforce locale context and cache rules in Shopify GraphQL?

The best way to enforce locale context and cache rules in Shopify GraphQL is by applying established guardrails and transforms. This practice reduces errors and prevents schema drift across the template.

Why does my Shopify storefront GraphQL query drift from the live schema?

Your Shopify storefront GraphQL query drifts from the live schema when operation structures and fragments lack canonical alignment. Referencing updated Storefront schema patterns prevents these inconsistencies and debugging issues.

Can I use Shopify GraphQL fragments and transforms across different storefront workflows?

Yes, you can use Shopify GraphQL fragments and transforms across different storefront workflows. The reference guide supports consistent, maintainable development by aligning these elements with the live Storefront schema.

How do I debug Shopify GraphQL caching conventions in a storefront template?

To debug Shopify GraphQL caching conventions in a storefront template, use reference guardrails to verify cache rules and transforms. This ensures your caching strategies align correctly with the live schema.