PREFLIGHT CHECK

Shopify CSV「options are not unique」を事前確認

同じHandle内でOption1〜3の値の組み合わせが重複していないか確認します。

CSVをチェック

🔒 解析はブラウザ内で完結し、ファイル自体はBlueprintLabへ送信しません。

このツールが見るもの

  • 同一Handle内のOption値重複
  • Option1〜3の組み合わせ
  • 重複した最初の行を表示

判定できないこと

サービス側の最新状態、アカウント固有設定、外部サーバー到達可否、最新マスタなど、ブラウザ内だけでは確定できない項目は断定しません。最終判定は公式情報を優先してください。

使い方と確認ポイント

同じHandle内でOption1〜3の値の組み合わせが重複していないか確認します。

  1. 「サンプルで試す」で付属データを確認できます。
  2. 「+ CSVファイルを選択 タップ/クリックで選択。PCではドラッグ&ドロップも使えます。」を指定します。
  3. 「CSVをチェックする」で処理します。
  4. 結果を元データと照合し、修正が必要な場合は入力欄へ戻ります。
+ CSVファイルを選択 タップ/クリックで選択。PCではドラッグ&ドロップも使えます。
.csv,text/csv

入力例・設定例

URL handle,Title,Option1 name,Option1 value,Price

「options are not unique」が出る前に、組み合わせを見ます

サイズと色のようなバリエーションを作るとき、同じ商品の中に `M / Black` が2行あると、Shopifyから見ると同じvariantを二重に作ろうとしている状態になります。このツールはURL handleごとにOption1〜3の値を組み合わせ、重複している行を探します。

値が同じかではなく、同じ商品内で「組み合わせが同じか」を見るのがポイントです。

Option名とvalueはペアです

`Option1 name=Size` なのに `Option1 value` が空、あるいはvalueだけある、といった片側だけの行も拾います。Option2・3も同じです。現在の小文字表記と旧テンプレートの大文字表記の両方を認識します。

バリエーション値がある行でURL handleが空なら、どの商品に属するvariantなのか決められないのでエラーです。

既存商品のOption値変更は、重複以外にも注意です

ShopifyではOption1〜3のvalueを変更すると、既存variant IDが作り直されることがあります。CSV上で重複がなくても、外部アプリがvariant IDを参照している場合は影響が出るんです。

このツールは重複と組み合わせ構造を見ます。既存商品のOption値そのものを変更する場合は、インポート確認画面でも意図を再確認してください。

例えば、Size×Colorなら

`S/Black`、`S/White`、`M/Black`、`M/White` の4行なら重複なしです。そこにもう1行 `M/Black` があれば、その行を具体的に示します。

同じ値を別商品で使うのは問題ありません。判定はURL handleごとの商品単位です。

もう少し知りたいとき
CSVを一括登録する前に見る5つ →