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

約5分で読めます

こんな人向けWooCommerceの商品CSVへカスタムフィールドを追加したい人

難易度入門

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

WooCommerceの商品CSVへ社内管理番号や独自属性を足したとき、列名を追加しただけでは取り込まれないことがあります。WooCommerceの標準インポーターは既知の列を自動マッピングし、独自メタデータは meta: プレフィックスを使う方法を案内しています。

既知の列と独自列を分ける

例えば product_depth というメタデータへ入れたいなら、ヘッダーを次のようにします。

SKU,Name,meta:product_depth
A001,Desk,60

「社内項目だから適当な列名でよい」と考えると、マッピング画面で未認識のまま残ります。

自動認識されない列は、インポート時のColumn mappingで意図したメタデータへ割り当てます。独自プラグインの項目は、そのプラグイン側の仕様も確認します。

WooCommerce CSVの通常列とmeta列を分ける図

新規CSVをゼロから組むより、WooCommerceから既存商品をエクスポートし、正しく出ている列構造をテンプレートとして使う方が安全です。独自項目を追加した後は少数商品で往復確認します。

アップロード前のヘッダー重複、列数不一致、重複行の検査には、CSV Preflightを使えます。

原本と修正版を分け、通常列とmeta列を1行目で確認します。少量商品を取り込み、管理画面でmeta値が意図した場所へ入ったことをREADBACKしてから全件へ広げます。

未認識列を無言で放置しないだけで、大量インポート事故のかなりの部分を入口で止められます。