Skuvera

「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 回出てきます。

修正方法

  1. エラーメッセージに書かれている handle を探します。
  2. その handle が付いたすべての行をファイル内で検索します。
  3. 行が 1 つの商品に属する場合は、それらを直接上下に並ぶように移動します。
  4. 別の商品に属する場合は、一方に新しい一意の URL handle を付けます。小文字、数字、ハイフンだけを使います。
  5. 同じ商品が 2 回出てくる場合は、重複した行を削除します。
  6. ファイルを 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 の重複を確認します。

インポート前にこの問題を検出

Skuvera はブラウザ内で、Shopify のすべてのルールに照らして商品 CSV をチェックし、問題の行と列を正確に特定します。無料・登録不要。

よくある質問

このエラーは、既存の商品が変更されたことを意味しますか?
いいえ。行はスキップされたので、その内容は何もインポートされていません。ファイルを修正して、これらの商品をもう一度インポートしてください。
「Overwrite products with matching handles」は何をするオプションですか?
選択すると、CSV 内の商品が、ストアにある同じ handle の既存の商品を置き換えます。ファイル内部の handle の重複は解消されません。

Skuvera の関連チェック

Shopify の公式説明を読む

その他のインポートエラー

2026年10月30日 更新