shopify-upgrade-migration

# 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 ```bash # Check what API version you're using in code grep -r "apiVersion" src/ --include="*.ts" --include="*.js" grep -r "api_version" . --include="*.toml" # Check what versions the store supports curl -s -H "X-Shopify-Access-Token: $TOKEN" \ "https://$STORE/admin/api/versions.json" \ | jq '.supported_versions[] | {handle, display_name, supported, latest}' ``` Shopify releases quarterly: `2024-01`, `2024-04`, `2024-07`, `2024-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 ...