| name | shopify-migration-deep-dive |
| description | Migrate e-commerce data to Shopify using bulk operations, product imports,
and the strangler fig pattern for gradual platform migration.
Use when replatforming to Shopify, importing product catalogs, or migrating customer and order data from another e-commerce system.
Trigger with phrases like "migrate to shopify", "shopify data migration",
"import products shopify", "shopify replatform", "move to shopify".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(node:*), Bash(curl:*) |
| version | 2.7.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","ecommerce","shopify"] |
| compatibility | Designed for Claude Code |
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, making it perfect for migrations. Handles variants, metafields, and all product attributes in a single mutation.
See Product Set Migration for the complete migration function.
Step 3: Bulk Operations for Large Imports
For importing thousands of products, use Shopify's staged uploads combined with bulk mutation to avoid rate limit issues.
See Bulk Operations Import for the staged upload and bulk mutation workflow.
Step 4: Set Inventory Levels & URL Redirects
After products are created, set inventory quantities at each location and create URL redirects to preserve SEO from the old platform.
