「Validation failed: options are not unique」というエラーを解消する

このエラーの意味

Shopify は各バリエーションを、オプション値の組み合わせ（Option1 value、Option2 value、Option3 value）で識別します。1 つの商品内では、2 つのバリエーションが同じ組み合わせを共有することはできません。Shopify が繰り返しの組み合わせを見つけると、このエラーでその商品を拒否します。

よくある原因

• バリエーションの行をコピーした際、オプション値を変更しませんでした。
• 2 つの異なる商品が同じ URL handle を使用しているため、Shopify はそれらの行を 1 つの商品のバリエーションとして読み込みます。
• オプション値が空白や大文字小文字だけで違っています（例: 「M」と「M 」）。Shopify はこれらを同じ値として扱います。

修正方法

1. エラーメッセージで商品を特定し、その URL handle が付いたすべての行を確認します。
2. 各行の Option1、Option2、Option3 の値を比較し、同じ組み合わせになっている行を見つけます。
3. 本当に重複している場合は、余分な行を削除します。別のバリエーションであれば、オプション値を変更します（例: White を Black に）。
4. 2 つの異なる商品が handle を共有している場合は、一方に新しい一意の URL handle を付けます。
5. ファイルを CSV UTF-8 形式で保存し、もう一度インポートします。

例

URL handle,Title,Option1 name,Option1 value,Option2 name,Option2 value,Price
linen-shirt,Linen shirt,Size,M,Color,White,39.00
linen-shirt,,,M,,White,39.00

URL handle,Title,Option1 name,Option1 value,Option2 name,Option2 value,Price
linen-shirt,Linen shirt,Size,M,Color,White,39.00
linen-shirt,,,M,,Black,39.00

どちらのバリエーションもサイズ M / White でした。2 つ目を Black に変更すると、各組み合わせが一意になります。

予防方法

• ファイルのコピーを URL handle とオプション値で並べ替えると、繰り返しの組み合わせに気づきやすくなります。
• 各商品のオプションの組み合わせをチェックするバリデーターを使用します。空白や大文字小文字だけが違う組み合わせも検出できます。

よくある質問

バリエーションが 1 つだけの商品にもオプション値が必要ですか？

バリエーションが 1 つの商品では、オプション名に Title、値に Default Title を使えます。複数のバリエーションがある商品だけが、区別できるオプション値を必要とします。

オプション値を変更すると、既存のバリエーションに影響しますか？

はい。Shopify によると、Option1、Option2、Option3 の値を変更すると、既存のバリエーション ID が削除されて新しい ID が作られます。バリエーション ID に依存するアプリや連携が壊れる可能性があります。

Skuvera の関連チェック

• バリエーションが重複しています

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

• 「Validation failed: price can't be blank」というエラーを解消する
• 「Ignored line because handle already exists」というエラーを解消する
• 「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 のインポートエラー