BASE の商品CSVチェッカー

商品の CSV と、画像の ZIP を選ぶと、BASE の「CSV商品管理 App」で取り込めない原因を、何行目のどこかまで教えます。

点検の基準は、BASE ヘルプの「CSV商品管理 App」の説明です(出典・2026-10-12 に確認)

ファイルはこの画面の中だけで調べます。送信も保存もしません。

使い方

  1. BASE の管理画面の「Apps」から「CSV商品管理」を開き、新規登録用の CSV をダウンロードして、商品を書き込みます。
  2. 商品の画像を1つのフォルダに入れ、ZIP に圧縮します。
  3. このページで、CSV ファイルを選びます。ZIP もあれば、続けて選びます。
  4. 「直す」と出たところを上から直し、もう一度ファイルを選びます。
  5. 「直す」が無くなったら、CSV商品管理 App に、CSV と ZIP を一緒にアップロードします。

BASE の説明では、画像だけをあとからアップロードすることはできません。CSV と ZIP は、同じときに選びます。

結果の見方

  • 直す:そのままだと、取り込みに失敗したり、その行が処理されなかったりします。
  • 見直す:取り込めても、思った結果にならないことがあります(価格が空で50円になる、など)。
  • 知っておく:取り込みの妨げにはなりませんが、知っておくと迷わないことです。

それぞれに、根拠が「BASE の説明にあります」か、「このツールの判断」かを付けています。

何を調べているか

文字コードShift_JIS か UTF-8 か。どちらでもなければ直す出典 1
CSV の大きさ10MB まで出典 1
1行目の列の名前BASE の名前のとおりか。少し違う名前(空白・括弧・全角)や、同じ名前の重複は直す出典 1
列の数1行目より多い、または少ない行(説明にカンマがあり「”」で囲んでいないと起きる)BASE の説明ではなく、このツールの判断
新規と更新商品IDが空なら新規、入っていれば更新。新規は1日1,000件まで、更新は1回に10,000件まで。上限のあとの行は処理されない出典 1
商品名新規は入力が要る。255文字以内。離れた行で同じ名前は、1つしか登録されない出典 1
種類(バリエーション)同じ商品名を続けて並べ、種類名を変える。種類名が空・重複は直す。1行だけの商品は「種類なし」になる出典 2
説明65,535バイト(全角で2万文字ほど)まで出典 1
価格カンマなし、50円以上。空なら50円で登録される出典 1
税率半角の 1(10%)か 2(8%)。空ならショップ設定のデフォルト税率出典 1
在庫数・種類在庫数半角の数字で10,000まで。種類がある商品の更新では、種類ID と種類在庫数が要る出典 1
公開状態半角の 1(公開)か 0(非公開)。空なら非公開で登録される出典 1
表示順半角の数字出典 1
画像1〜20拡張子が jpg・png・gif か。ファイル名に日本語がないか出典 1
画像の ZIP(選んだとき)全体で 1GB まで、画像は1枚 10MB まで。画像が二重のフォルダに入っていないか。CSV の画像の名前が ZIP の中にあるか(大文字と小文字も)出典 3

このツールにできないこと

  • 取り込みが成功するかどうかは、約束できません。BASE の中の確認を、すべて再現しているわけではないからです。最後は、CSV商品管理 App の「履歴」と、エラーが出たときの「エラーログ」で確かめてください。
  • 商品の中身は見ません。説明の内容、価格が適切か、画像の絵柄、販売できる商品かどうかは、調べていません。
  • 登録した商品は、BASE の説明では一括で削除できません。最初は2〜3行だけで試してから、全部を入れると安心です。

出典

  1. 【CSV商品管理 App】利用開始から商品情報の一括登録・編集までの流れを教えてください(BASE ヘルプ)
  2. 種類が複数ある商品を、一括で登録できますか(BASE ヘルプ)
  3. 画像をアップロードしても反映・更新されません(BASE ヘルプ)

どれも 2026-10-12 に、BASE の公式のヘルプで確かめました。説明が変わったときは、このページも直します。

このチェッカーは crossclub design が作ったもので、BASE の公式のものではありません。BASE の機能や、取り込みの結果についてのご質問は、BASE のヘルプからお問い合わせください。

選んだファイルは、ブラウザの中だけで読み、サーバーには送りません。このページが使われた回数と、見つかった問題の数(ファイルの名前や中身は含みません)は、Google アナリティクスで集計しています。くわしくはプライバシーポリシーをご覧ください。


商品の手数料や手取りは、BASE の手数料・手取り計算機で計算できます。BASE のテーマ OMOTASE は、食品ギフトのショップ向けです。