「Ignored line because handle already exists」というエラーを解消する
その行の URL handle が、ファイル内で先に出てきた商品ですでに使われていたため、Shopify はこの行をスキップしました。1 つの商品のすべての行を続けてまとめ、2 つの異なる商品が同じ handle を共有しないようにしてください。
Shopify のエラーメッセージ
Ignored line #-## because handle example already exists
このエラーの意味
URL handle は各商品を一意に識別します。Shopify は行を上から下へ読み、同じ handle が続く行を 1 つの商品にまとめます。同じ handle が別の商品の後にもう一度現れたり、2 つ目の商品がすでに使われた handle で始まったりすると、Shopify はそれらの行を無視します。
よくある原因
- 表計算ソフトで URL handle 以外の列を基準にファイルを並べ替えたため、1 つの商品の行が離れてしまいました。
- 2 つの異なる商品に同じ handle が付いています。多くはタイトルが似ていることが原因です。
- 複数のエクスポートの行を結合したため、同じ商品が 2 回出てきます。
修正方法
- エラーメッセージに書かれている handle を探します。
- その handle が付いたすべての行をファイル内で検索します。
- 行が 1 つの商品に属する場合は、それらを直接上下に並ぶように移動します。
- 別の商品に属する場合は、一方に新しい一意の URL handle を付けます。小文字、数字、ハイフンだけを使います。
- 同じ商品が 2 回出てくる場合は、重複した行を削除します。
- ファイルを CSV UTF-8 形式で保存し、もう一度インポートします。
例
URL handle,Title,Option1 name,Option1 value,Price cotton-tee,Cotton tee,Size,S,25.00 linen-shirt,Linen shirt,Size,S,39.00 cotton-tee,,,M,25.00
URL handle,Title,Option1 name,Option1 value,Price cotton-tee,Cotton tee,Size,S,25.00 cotton-tee,,,M,25.00 linen-shirt,Linen shirt,Size,S,39.00
cotton-tee のサイズ M の行が linen-shirt の後に来ていたため、Shopify はこれを無視しました。最初の cotton-tee の行のすぐ下に移動すると、インポートできます。
予防方法
- 表計算ソフトで商品 CSV を並べ替えないでください。Shopify は、並べ替えると画像が商品から切り離されることもあると警告しています。
- インポート前に、特にファイルを結合した後は、handle の重複を確認します。
よくある質問
- このエラーは、既存の商品が変更されたことを意味しますか?
- いいえ。行はスキップされたので、その内容は何もインポートされていません。ファイルを修正して、これらの商品をもう一度インポートしてください。
- 「Overwrite products with matching handles」は何をするオプションですか?
- 選択すると、CSV 内の商品が、ストアにある同じ handle の既存の商品を置き換えます。ファイル内部の handle の重複は解消されません。
Skuvera の関連チェック
Shopify の公式説明を読むその他のインポートエラー
- 「Validation failed: price can't be blank」というエラーを解消する
- 「Validation failed: options are not unique」というエラーを解消する
- 「Ignored line because it did not contain product data」というエラーを解消する
- 「Invalid CSV header: missing headers」というエラーを解消する
- 「Network error: Unexpected token < in JSON at position 0」というエラーを解消する
- Shopify CSV のインポートエラー
2026年10月30日 更新
Skuvera