CSVインポートエラー解決
Shopifyでバリアント・画像URLの行ズレ／取込停止を「視覚化」して直す
「インポート成功」と出たのに商品が0件／バリアントが反映されない／ 画像が付かない──これらは別々の不具合に見えて、原因は数個の定番パターンに集約されます。 Shopifyの成功メッセージは0行しか処理しなくても表示されるため、サイレントに失敗しがちです。
原因1：画像行が「バリアント」と誤認されている
追加画像の行は、同じHandleで Image Src だけを入れ、 Option値・SKU・価格・Titleは空にします。ここにOption値などが残ると、 Shopifyはその行をバリアント行と誤解し、取り込みが崩れます。
Handle,Title,Option1 Value,Variant SKU,Image Src
cap,キャップ,Free,CAP-1,https://cdn.example.com/cap-1.jpg
cap,,,,https://cdn.example.com/cap-2.jpg ← 画像のみの行（正しい）
cap,,Free,,https://cdn.example.com/cap-3.jpg ← Option値が残り誤バリアント化（NG）
原因2：Image Src が絶対URLでない
Image Src は https:// で始まる公開された絶対URLでなければなりません。 相対パス・ローカルパス・http://（非SSL）・スペース混入は取り込まれません。
- OK: https://cdn.example.com/img.jpg
- NG: img.jpg / C:\images\img.jpg / www.example.com/img.jpg
- 画像はインターネットから誰でもアクセスできる場所に置く（認証付きURLは不可）。
原因3：Variant Price に通貨記号・カンマが混ざっている
Variant Price は数字のみです。通貨記号・カンマ・空白が入ると弾かれます。
- OK: 1999.00
- NG: $1,999.00 / ¥1980 / 1 980
原因4：Handleの非連続・重複SKU・バリアント上限
- 同じHandleは連続させる。離れた場所で再登場すると別商品に分裂したり上書きされる。
- SKUの重複は在庫・バリアントの取り違えを招く。1バリアント＝1SKUに。
- 1商品あたりのバリアント数には上限がある。オプションの組合せが多すぎる（例: 2×49×3）と上限超過で失敗する。組合せを見直す。
無料プリフライトは、画像行の誤バリアント化・Image SrcのURL不正・価格の通貨記号混入・重複SKU・ Handle欠落を行番号つきで列挙します。サイレント失敗を取込前に可視化。完全ブラウザ内・アップロード無し。
行単位で診断する →よくある質問
「成功」と出たのに商品が1件も増えません。
Shopifyの成功表示は0行処理でも出ます。Handle欠落・画像行の誤り・価格の不正などで全行スキップされている可能性が高いです。ツールで致命エラーが0件になるまで直してください。
画像URLは合っているのに反映されません。
URLが認証必須・非公開・http://（非SSL）でないか、画像行にOption値が混ざって誤バリアント化していないかを確認してください。
親商品だけ入ってバリアントが入りません。
バリアント行のHandleが先頭行と一致しているか、Option1 Name/Valueが正しく入っているかを確認。Default Titleの記事も関連します。