Agent skill · software engineering · jeremylongshore
shopify-upgrade-migration
Upgrade Shopify API versions and migrate from REST to GraphQL with breaking
Why this skill is useful
Adds executable scripts and detailed migration patterns for upgrading Shopify API versions and transitioning from REST to GraphQL, which are not commonly found in public documentation.
What it needs
Requires jq installed locally. Requires shopify account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Shopify Upgrade & Migration Overview Guide for upgrading Shopify API versions (quarterly releases) and migrating from the legacy REST Admin API to the GraphQL Admin API. REST was deprecated as a legacy API on October 1, 2024. Prerequisites Current Shopify API version identified Git for version control Test suite available Access to Shopify release notes Instructions Step 1: Check Current Version and Available Versions Shopify releases quarterly (e.g., 2025-01, 2025-04, 2025-07, 2025-10). Versions are supported for ~12 months after release. Step 2: Review Breaking Changes Key breaking changes by version: Version Breaking Change Migration --------- ---------------- ----------- 2024-10 ProductInput split into ProductCreateInput + ProductUpdateInput Update mutations to use separate types 2024-10 REST declared legacy Migrate to GraphQL Admin API 2024-07 InventoryItem.unitCost removed Use InventoryItem.unitCost on InventoryLevel 2024-04 Cart warnings replace inventory userErrors (Storefront) Update cart error handling 2025-01 New public apps must use GraphQL only No REST for new public apps Step 3: Migrate REST to GraphQL Side-by-side comparison of REST vs GraphQL patterns, plus a mapping table for common endpoints (products, orders, customers, webhooks). See REST to GraphQL Migration for the complete examples and mapping table. Step 4: Update API Version in Config Step 5: Handle the ProductInput Split (2024-10) In API version 2024-10, Shopify split the single ProductInput type into ProductCreateInput and ProductUpdateInput. All product mutations need updating. See ProductInput Split for before/after examples. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/shopify-upgrade-migration