shopify-migration-deep-dive

# Shopify Migration Deep Dive ## Overview Migrate product catalogs, customers, and orders to Shopify using the GraphQL Admin API bulk mutations, CSV imports, and incremental migration patterns. ## Prerequisites - Source platform data exported (CSV, JSON, or API access) - Shopify store with appropriate access scopes - Scopes needed: `write_products`, `write_customers`, `write_orders`, `write_inventory` ## Instructions ### Step 1: Assess Migration Scope | Data Type | Shopify Import Method | Complexity | |-----------|----------------------|------------| | Products + variants | `productSet` mutation (upsert) | Low | | Product images | `productCreateMedia` mutation | Low | | Customers | Customer CSV import or `customerCreate` | Medium | | Historical orders | `draftOrderCreate` + `draftOrderComplete` | High | | Inventory levels | `inventorySetQuantities` mutation | Medium | | Collections | `collectionCreate` mutation | Low | | Redirects (URLs) | `urlRedirectCreate` mutation | Low | | Metafields | Included in product/customer mutations | Medium | ### Step 2: Bulk Product Import with productSet `productSet` is idempotent — it creates or updates based on `handle`. Perfect for migrations. ```typescript const PRODUCT_SET = ` mutation productSet($input: ProductSetInput!) { productSet(input: $input) { product { id title handle variants(first: 50) { edges { node { id sku price inventoryQuantity } } ...