PREFLIGHT CHECK

Shopify CSVのSKU・重量とOption1依存関係を事前確認

SKU・Barcode・重量・在庫などのバリエーション項目を更新する行にOption1 name / valueが揃っているか確認します。

CSVをチェック

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

このツールが見るもの

  • SKU/Barcode/重量/在庫の更新行
  • Option1 name/value列の存在
  • Option1値の空欄

判定できないこと

この非公式ツールはブラウザ内で確認できる範囲だけを判定します。アカウント固有設定、外部サーバーの状態、サービス側の最終判定は公式情報を優先してください。

使い方と確認ポイント

SKU・Barcode・重量・在庫などのバリエーション項目を更新する行にOption1 name / valueが揃っているか確認します。

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

入力例・設定例

URL handle,Title,Option1 name,Option1 value,SKU,Weight value (grams)
sample-shirt,Sample Shirt,Size,M,SHIRT-M,250

SKUだけ直したつもりで、variant構造まで変わるのが怖いところです

Shopifyの商品CSVでは、SKUや重量のようなvariant関連列はOption1 name / Option1 valueと依存関係があります。既存商品を更新するときにOption列を外したままvariant情報だけ入れると、既存variantの削除や既定variantへの置き換えにつながることがあります。

このツールは「SKUや重量の値があるのに、Option1の文脈がない行」を先に見つけます。

新規単品商品と既存更新は同じ判定にできません

新しい単品商品なら、明示的なOptionを持たずに既定variantとして作れるケースがあります。だからOption1が丸ごと無いだけで一律エラーにはしません。既存更新では危険なので警告、nameかvalueの片方だけなら構造不整合としてエラーにします。

ここを全部エラーにすると、新規単品商品の正常CSVまで赤くしてしまうんですよ。

どの列を「variant関連」と見ている?

SKU、Barcode、Price、Inventory quantity、Weight value (grams) と、それらの旧テンプレート列名を対象にします。値が入っている行だけを見て、Option1 name / valueとの関係を確認します。

商品説明やVendorのような商品レベル列だけを直す行は、この依存関係チェックの対象ではありません。

更新CSVなら、元のOptionを消さないのが基本です

既存商品のSKUを一括更新したいなら、現在の商品CSVをエクスポートし、URL handleとOption列を残したままSKUだけ編集する方が安全です。

インポート前に少数商品で試し、variant IDや外部連携に影響がないことを確認してから全件へ広げます。

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