About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/shopify-pack/skills/shopify-migration-deep-dive/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill shopify-migration-deep-dive. Copyright stays with the author (MIT).

Shopify Migration Deep Dive

Name: shopify-migration-deep-dive
Author: jeremylongshore

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.

See Inventory and Redirects for both mutation implementations.

Step 5: Post-Migration Validation

Automated validation that compares expected source counts against actual Shopify counts for products, customers, and other data types.

See Post-Migration Validation for the validation script.

Output

Products migrated with variants, images, and metafields
Inventory levels set at correct locations
URL redirects preserving SEO
Migration validated against source counts

Error Handling

Issue	Cause	Solution
`TAKEN` on product handle	Duplicate handle	Append suffix or use `productSet` for upsert
Rate limited during import	Too many sequential calls	Use bulk operations or add delays
Image upload fails	URL not publicly accessible	Use staged uploads for private images
Inventory not updating	Wrong `inventoryItemId`	Query variant's `inventoryItem.id` first

Examples

Quick Migration Status

# Count products in source vs Shopify
echo "Shopify product count:"
curl -sf -H "X-Shopify-Access-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ productsCount { count } }"}' \
  "https://$STORE/admin/api/${SHOPIFY_API_VERSION:-2025-04}/graphql.json" \
  | jq '.data.productsCount.count'

Resources

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-shopify-migra-226112/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-shopify-migra-226112.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-shopify-migra-226112",
  "kind": "skill",
  "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\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding",
      "customer_support"
    ],
    "tags": [
      "skill-md",
      "saas",
      "ecommerce",
      "shopify",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/saas-packs/shopify-pack/skills/shopify-migration-deep-dive/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/shopify-pack/skills/shopify-migration-deep-dive/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/shopify-pack/skills/shopify-migration-deep-dive/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(node:*),",
      "Bash(curl:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# Shopify Migration Deep Dive\n\n## Overview\n\nMigrate product catalogs, customers, and orders to Shopify using the GraphQL Admin API bulk mutations, CSV imports, and incremental migration patterns.\n\n## Prerequisites\n\n- Source platform data exported (CSV, JSON, or API access)\n- Shopify store with appropriate access scopes\n- Scopes needed: `write_products`, `write_customers`, `write_orders`, `write_inventory`\n\n## Instructions\n\n### Step 1: Assess Migration Scope\n\n| Data Type | Shopify Import Method | Complexity |\n|-----------|----------------------|------------|\n| Products + variants | `productSet`",
  "cost": {
    "context_tokens": 920
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-shopify-migra-226112/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.