| name | sales-shopify |
| description | Shopify platform help — the leading commerce platform for makers and DTC sellers: products, orders, customers, checkout, discounts, and headless storefronts via the GraphQL Admin API (REST is now legacy) plus HMAC-signed webhooks and the Storefront API. Use when building a Shopify Admin API or webhook integration, webhook HMAC verification failing the mandatory GDPR/compliance automated checks, hitting GraphQL query-cost throttling or a 429/THROTTLED and needing backoff or bulk operations, migrating an integration off the legacy REST Admin API to GraphQL, checkout customization gated to Shopify Plus (checkout.liquid deprecated for Checkout Extensibility), third-party payment-provider transaction fees eating margin, syncing orders or customers into a CRM or data warehouse, or choosing between Basic, Grow, Advanced, and Plus. Do NOT use for checkout-conversion strategy across carts (use /sales-checkout) or picking a Merchant of Record for global tax (use /sales-merchant-of-record). |
| argument-hint | [describe what you need help with in Shopify — e.g. 'verify a webhook HMAC' or 'sync orders to my CRM'] |
| license | MIT |
| version | 1.0.1 |
| tags | ["sales","checkout","ecommerce","platform"] |
| github | https://github.com/Shopify |
Shopify Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
Figure out what the user actually needs before diving in:
- Goal — building/debugging an API or webhook integration, choosing a plan, a checkout/conversion question, or a store-ops task?
- Surface — GraphQL Admin API, REST Admin API (legacy), Storefront API, webhooks, or the no-code admin?
- App type — custom app (token from admin) or public app (OAuth, Dev Dashboard)?
- Plan — Basic, Grow, Advanced, or Plus? (Some features — Checkout Extensibility, higher API limits, B2B — are Plus-gated.)
Skip-ahead rule: if the prompt already says what they need, go straight to Step 2.
Step 2 — Route or answer directly
If the question is really about a cross-platform strategy, hand off with the exact command:
| If the user wants… | Route to |
|---|
| Checkout conversion / order bumps / cart-abandonment tactics across carts | /sales-checkout {question} |
| Whether to use a Merchant of Record for global VAT/sales tax | /sales-merchant-of-record {question} |
| Digital-product pricing & launch strategy | /sales-digital-products {question} |
| Wiring Shopify into another tool via iPaaS | /sales-integration {question} |
| Post-purchase email / abandoned-cart sequences | /sales-email-marketing {question} |
Otherwise it's a Shopify-specific question — answer it here.
Step 3 — Shopify platform reference
Read references/platform-guide.md for the full reference — capabilities and what's API vs webhook vs UI-only, pricing/plan gates, data model with JSON shapes, and quick-start recipes. For raw endpoint/auth/rate-limit/webhook detail, read references/shopify-api-reference.md.
Answer using only the relevant section — don't dump the whole guide.
Step 4 — Actionable guidance
- Build on GraphQL. REST Admin API is legacy as of 2024-10-01; new public apps must be GraphQL-only since 2025-04-01, and new features ship GraphQL-first. Don't start a new integration on REST.
- Compute HMAC-SHA256 over the request body with your app's API secret, base64-encode, and timing-safe-compare to . The three mandatory GDPR/compliance webhooks must pass this or app review fails.
