CSVGuide2026-10-12

WooCommerce CSVはアップロード前より「列マッピング画面」で事故を止める

約5分で読めます

こんな人向けWooCommerceの商品CSVを安全に一括インポートしたい人
難易度入門

WooCommerceの商品CSVインポートで、認識された列と未認識列をColumn mapping画面で確認し、誤った対応付けを大量反映する前に止める手順です。

目次を開く

WooCommerceの商品CSVは、ファイルを選んだ直後に大量更新されるわけではありません。標準インポーターにはColumn mappingがあり、CSVの列をWooCommerceのどの商品フィールドへ割り当てるか確認できます。ここを読み飛ばさないことが重要です。

自動マッピングを信用しすぎない

Name、SKU、Description など既知の列は自動で対応しやすい一方、社内独自の列や名前を変えた列は未認識になることがあります。特に価格、在庫、公開状態の誤マッピングは大量更新事故につながります。

未認識列を意図的に処理する

不要な列ならインポート対象から外し、必要なメタデータなら適切な宛先へマッピングします。「分からないけどRun importer」は避けます。

WooCommerceのCSV列を商品フィールドへマッピングする図

本番前に小さいCSVを通す

数商品だけでインポートし、商品画面で名前、SKU、価格、属性、公開状態をREADBACKします。その後に全件へ広げれば、構造ミスの影響範囲を小さくできます。

ファイル側の列数不一致、重複、引用符崩れは、インポーターへ渡す前にCSV Preflightで確認できます。

本番投入前の最終チェック

CSVの1行目とマッピング画面を並べ、重要列が正しい宛先へ向いていることを確認します。少量商品で実データを確認してから全件へ広げます。

  • 価格・SKU・在庫・公開状態を確認した
  • 未認識列を放置していない
  • 少量テストを通した
  • 取り込み後をREADBACKした
  • 全件前にバックアップした

ファイルが正しくても、インポーター側の解釈が違えば事故になるので、マッピング画面を検査工程として扱います。

少量テストのマッピングを証拠に残す

本番前テストで正しく割り当てられたら、CSVヘッダーとWooCommerce側フィールドの対応を記録します。次回のインポートで列名が変わったときに差分を発見でき、価格や在庫が別フィールドへ入る事故を減らせます。本番後は代表商品を開き、CSVの値と商品画面の値を比較して、インポート完了ではなく反映結果まで確認します。

NEXT

次に読む。

CSV / Guide

WooCommerce CSVの独自項目は、放置せずmeta列として扱う

約5分

WooCommerceの商品CSVに独自項目を追加するとき、未知の列が自動で入ると思わず、meta:プレフィックスと列マッピングを使う考え方を整理します。

CSV / Guide

WooCommerceの可変商品CSVは、親行とvariation行を先に設計する

約5分

WooCommerceのCSVで可変商品を登録するときに、親商品、variation、SKU、Parent、属性名と値の関係を先に組み立てる実務手順です。

CSV / Guide

CSVの住所や説明文にカンマがあるなら、そのセルだけ引用符で囲む

約5分

CSVの値そのものにカンマが含まれると列がずれる理由と、RFC 4180の基本に沿って二重引用符で1フィールドとして保持する方法を整理します。

SHARE
XBLUESKYFACEBOOKLINE