ShopifyのCSV商品一括インポート手順｜エラー対処も解説

商品数が増えてきたのに管理画面で1点ずつ登録を続けていると、商品登録だけで1日が終わる状況は珍しくありません。CSVファイルを使った一括インポートは、数百点規模の登録作業を数時間まで圧縮できる方法です。

本記事では、Shopifyの商品CSVの作り方からインポート手順、エラー対処までを実務の流れに沿って解説します。「CSVのエラーが解決できない」「商品登録に時間を取られて販促まで手が回らない」といったご相談があれば、ぜひお気軽にご相談ください。▶ サービス紹介資料をダウンロードする（無料）

ShopifyのCSV一括インポートでできることと事前に知るべき制限

「新商品を50点追加してほしい」と頼まれ、管理画面とにらめっこしながら数日がかりで入力した経験を持つEC担当者は少なくありません。商品登録は売上に直結しにくい裏方の作業でありながら、EC運営の中でも特に時間を奪われやすい工程です。

国内のEC市場は物販分野だけで年間14兆円を超える規模に拡大し、新規参入も増え続けています。商品登録のスピードと正確さは、競争の入口を支える基礎体力です。

Shopifyには、CSV（カンマ区切りのテキストファイル）で商品情報を一括で取り込む機能が標準で備わっています。表計算ソフトで商品データをまとめて編集し、管理画面から1回の操作で取り込めるため、登録作業の進め方そのものを変えられる機能です。

CSVインポートで一括処理できる内容

商品CSVで取り込めるのは、商品名や説明文だけではありません。価格、SKU（在庫管理用の商品コード）、在庫数、タグ、公開状態、SEO用のページタイトルまで、商品ページを構成する大半の情報を1枚のファイルで扱えます。

新規登録だけでなく、既存商品の情報をまとめて書き換える一括更新にも使える点が強みです。セール対象商品の価格を一斉に変更する作業も、CSVの編集と再インポートだけで完了します。

プラットフォーム移行時のデータ引っ越しも、商品CSVが主役になる場面です。他のカートからエクスポートした商品データをShopifyの形式へ整形すれば、移行作業の大部分を自動化できます。

商品データをCSVとして手元に保管する習慣は、棚卸しやバックアップの台帳づくりにも有効です。在庫数や価格の一覧をファイル単位で時系列管理できるため、トラブル時の復元や監査にも役立つでしょう。

一方、CSVだけでは扱えない情報も存在します。定期購買の契約情報や顧客データは商品CSVの対象外で、別形式のファイルや専用機能で取り込む決まりです。

商品データのエクスポートも、同じ「商品管理」画面から数クリックで実行できます。「エクスポート」をクリックし、対象範囲とファイル形式を選ぶだけの簡単な操作です。

インポートとエクスポートの往復は、CSV管理の基本サイクルといえます。最新データを吐き出し、編集して戻す流れを覚えると、商品データベースとしての使い道が広がるはずです。

手動登録との作業量の差を数字で見る

管理画面から1商品を登録すると、画像設定や説明文入力を含めて1点あたり5〜10分はかかります。100点なら単純計算で8〜16時間となり、他業務と並行すれば1週間仕事になっても不思議ではありません。

CSVで同じ100点を処理する場合、データ入力はスプレッドシート上のコピーや関数で進められます。実際に一括登録へ切り替えた事業者からは、作業時間が数十分の一になったという報告もありました。

300点の商品を扱う店舗が移行で全件登録をやり直すケースなら、手動では丸1週間かかる計算です。CSVを使えば、データ整形に1日、インポートと確認に半日という規模感で収まります。

登録初日から全商品を販売開始できるかどうかは、立ち上げ時の売上計画に直結する条件です。オープン日程が決まっている案件ほど、CSVの恩恵は大きくなります。

入力ミスの抑制という副次効果も見逃せません。手入力では価格の桁間違いや表記ゆれが混ざりやすい一方、CSVなら一覧での目視確認や一括置換ができるため、データの品質を均一に保ちやすい構造です。

浮いた時間は、商品ページの磨き込みや集客施策に振り向けられます。登録作業の仕組み化は単なる時短ではなく、運営リソースの再配分という意味を持つはずです。

商品数の規模で手段を使い分ける

商品が10点前後までなら、管理画面からの手動登録でも大きな負担にはなりません。バリエーションの設定画面を直接確認しながら進められるため、Shopifyの構造を学ぶ段階ではむしろ手動が向いています。

50点を超えたあたりからは、CSVによる一括処理が現実的な選択肢です。数千点規模の運用や基幹システムとの定期連携が必要な場合は、MatrixifyのようなCSV拡張系アプリの導入も視野に入ります。

アプリ経由なら、メタフィールドや注文データの一括処理まで対応範囲が広がる点が魅力です。月額費用が発生するため、標準機能で足りる規模のうちは無理に導入する必要はありません。

判断に迷う規模なら、まず標準のCSV機能で1サイクル回してみる進め方が堅実です。実際の作業時間を測ったうえで、アプリへ投資すべきかを判断しても遅くありません。

インポート前に押さえる3つの制限

便利な機能ですが、Shopifyの商品CSVには明確な上限があります。1つ目はファイルサイズで、15MBを超えるCSVはインポートできません。

2つ目はバリエーション数に関する制限です。バリエーション総数が5万件を超えるストアでは、Plusプランを除き、24時間以内にCSVやAPIで作成できる新規バリエーションが1,000件までに絞られます。

3つ目は画像の仕様で、商品画像は最大5,000×5,000ピクセルまでという条件です。上限を超える画像URLを指定すると検証エラーで弾かれるため、アップロード前に画像サイズをそろえておくと安全でしょう。

立ち上げ期のストアで15MBを超えるケースはまれですが、商品説明のHTMLが長いと容量は意外と膨らみます。上限に近づいたら、商品カテゴリごとにファイルを分割してインポートする方法が現実的です。

ストア構築の全体像や費用感をこれから整理する段階なら、商品登録の工数も計画に織り込んでおくと予算のぶれを防げます。構築会社へ依頼する場合も、商品データの準備をどちらが担当するかで見積もりが変わる点も見逃せません。

関連記事：Shopify構築費用

インポート前の準備：テンプレート入手とCSVファイルの作り方

「CSVを作ってアップロードしたのに、原因不明のエラーで何度もやり直しになった」という悩みは、Shopify運用の相談で特に多いテーマです。失敗の原因の大半は操作ミスではなく、ファイルを作る前の準備不足にあります。

インポート操作そのものは数クリックで終わるため、準備の質が成功率を決めるといっても過言ではありません。最初に編集環境とファイルの土台を整えてから、データ入力に進む流れが安全です。

準備段階の論点は、テンプレートの入手元・編集環境・テスト方法の3つに集約されます。判断基準とあわせて、順に見ていくと迷いません。

公式のサンプルCSVをダウンロードする

CSVファイルを白紙から自作する方法は、リスクが高いため避けるほうが無難です。列名（ヘッダー）のつづりが1文字違うだけでも、Shopifyは列を認識できずエラーを返してしまいます。

確実なのは、Shopifyが配布する公式のサンプルCSVを土台にするやり方です。管理画面の「商品管理」で「インポート」をクリックすると表示されるポップアップ内に、サンプルファイルのダウンロードリンクがあります。

サンプルには見本の商品データが入っており、各列に入れる値のイメージに迷いません。見本行を残したまま取り込むと架空の商品が登録されてしまうため、本番データへの置き換えか削除が前提です。

サンプルの見本行からは、バリエーションや複数画像の行構成も学べます。自社商品の入力前に見本の構造を一度眺めておくと、理解が早まるはずです。

列の並び順は基本的に変えず、使わない列の値は空欄のままにしておくのが基本形でしょう。列ごと削除する方法は更新時には便利ですが、新規登録に慣れるまではサンプルの構造を維持したほうがトラブルを避けられます。

編集環境はGoogleスプレッドシートが無難

CSVの編集には、ExcelよりもGoogleスプレッドシートを選んでおけば間違いありません。Shopify公式も、文字コードのトラブルを避ける観点でスプレッドシートの利用を案内しているためです。

Shopifyが受け付ける文字コードはUTF-8のみで、Windows版Excelの標準的な保存形式であるShift_JISのままでは日本語が文字化けします。商品名や説明文が記号の羅列になる現象は、ほぼ文字コードの不一致が原因でした。

スプレッドシートなら、編集後に「カンマ区切り形式（.csv）」でダウンロードするだけでUTF-8の条件を満たせます。Excelを使う場合は、保存時に「CSV UTF-8（コンマ区切り）」を明示的に選んでください。

テキストエディタで編集する場合は、BOM（ファイル先頭の特殊な符号）にも注意が要ります。ShopifyはBOMなしUTF-8を前提とするため、保存形式の選択肢に「UTF-8（BOMなし）」があれば、そちらを選ぶのが確実です。

表計算ソフト特有の自動変換にも警戒してください。SKUの先頭のゼロが消えたり「1-2」のような表記が日付に変わったりするため、該当する列はあらかじめ書式を「書式なしテキスト」へ設定しておくと事故を防げます。

複数人でCSVを編集する体制なら、共有のしやすさでもスプレッドシートが有利です。同じファイルを同時に編集できるため、商品情報の入力と画像URLの貼り付けを分担する進め方も組めます。

編集メンバーが複数いる場合は、列の入力ルールを最初に1枚のメモへまとめておくと混乱しません。価格は税込みか、タグの区切りは半角かといった細部のずれが、後のエラーにつながります。

2〜3件のテストインポートで検証する

準備の仕上げは、少量データでのテストインポートです。いきなり数百件を流し込むと、設定ミスがあった場合に大量の商品データを修正する羽目になり、かえって時間を失います。

現場で定着しているのは、まず2〜3件だけ入力したCSVで取り込みを試し、商品ページの表示まで確認してから全件を投入する手順です。価格・画像・バリエーションが意図どおり反映されたかを、実際の画面で確かめておくと安心できます。

テストで登録した商品は、確認後に削除するか下書きへ戻せば本番に影響しません。10分程度のテストを挟むだけで、数時間規模の手戻りを未然に防げます。

テスト段階では、スマートフォンでの表示確認も済ませておきたいところです。ECサイトの閲覧の多くはスマートフォン経由のため、説明文のHTML崩れは小さい画面でこそ見つかります。

テスト商品には「test-」のような専用のHandle接頭辞を付けておくと、後始末が確実です。検索一発でテストデータを抽出できるため、本番商品に紛れて残り続ける事故を避けられます。

本番投入の前には、ファイル名に日付を入れたバージョン管理もおすすめです。「products_20260612.csv」のように残しておけば、どの時点のデータを取り込んだかを後から追跡できるでしょう。

テスト時の確認観点は、文字化け・価格・画像・バリエーションの4点に絞ると効率的です。4点さえ通っていれば、残る不具合は軽微な修正で済む場合がほとんどでした。

準備からテストまでの一連の流れは、初回こそ半日仕事ですが、2回目以降は1時間程度で回せるはずです。手順書として社内に残しておけば、担当者が変わっても品質を保てます。

なお、テスト用とはいえ実在しない価格や在庫数を入れたまま公開すると、誤注文の火種になりかねません。テスト中はStatusをdraftにしておく設定が、もっとも確実な保険です。

商品CSVの必須項目と主要な列の書き方

サンプルCSVを開いた瞬間、横一列に並ぶ大量の英語ヘッダーを見て手が止まる担当者は多いでしょう。実際にはすべての列を埋める必要はなく、入力必須の項目はごく一部です。

列の役割さえ理解すれば、自社に必要な項目だけを選んで入力できるため、見た目ほど難しくありません。最低限の必須列と、実務でほぼ確実に使う主要列を順に整理します。

必須はHandleとTitleの2列だけ

商品CSVで入力が必須なのは、Handle（ハンドル）とTitle（商品名）の2列です。極端にいえば、2列さえ埋まっていれば商品はShopifyに登録されます。

Handleは商品を一意に識別するIDで、商品ページURLの一部にもなる値です。使える文字は半角英数字とハイフンのみで、ストア内での重複は許されません。

たとえばHandleに「organic-tshirt」と入力すると、商品URLは「ストアドメイン/products/organic-tshirt」という形になります。後から変更するとURLごと変わって検索エンジンからの評価が分断されるため、命名ルールは最初に決めておくのが現実的です。

Titleは顧客にそのまま表示される商品名で、検索結果にも露出します。「オーガニックコットンTシャツ 半袖」のように、特徴がひと目で伝わる名前が理想です。

SKUとHandleの役割は、初期に混同しやすいポイントとして知られています。SKUは社内の在庫管理用コード、Handleは顧客に見えるURL用のIDという違いを押さえておけば混乱しません。

実務でよく使う主要列

必須の2列に加えて、実際の運用では10前後の列を使うケースが大半です。なかでも使用頻度の高い列を先に押さえておくと混乱しません。

• Body (HTML)：HTML形式の商品説明文
• Vendor：販売元・ブランド名
• Type：商品タイプ（分類用）
• Tags：カンマ区切りの商品タグ
• Variant SKU：在庫管理用の商品コード
• Variant Price：販売価格（記号なしの数値）
• Variant Inventory Qty：在庫数

Body (HTML)には商品説明文をHTML形式で入力し、太字や改行などの装飾も反映させられます。改行はセル内改行ではなく、brタグなどのHTMLで表現する点が独特です。

Tagsはカンマ区切りで複数指定でき、「Tシャツ, 夏物, セール」のように書きます。タグはコレクションの自動振り分けや検索絞り込みの軸になるため、付け方のルールを先に決めておくと運用が安定するはずです。

価格欄のVariant Priceに「¥2,980」のように通貨記号や桁区切りカンマを入れると、エラーや誤登録を招きます。数値は「2980」のような記号なしの半角で統一してください。

二重価格で割引を見せたい場合は、Variant Compare At Priceに割引前の価格を入れます。Variant Priceが実売価格、Compare At Priceが定価という対応関係を覚えておけば迷いません。

SEO TitleとSEO Descriptionの2列では、検索結果に表示するページタイトルと説明文を商品ごとに指定できます。空欄の場合はTitleとBody (HTML)の内容が自動で使われるため、検索流入を狙う主力商品から優先して入力すると効率的です。

配送料の計算に重量を使う店舗では、Variant Gramsに商品重量を数値で入力します。単位の指定はVariant Weight Unit列の役割で、「g」「kg」などの値を入れる決まりでした。

VendorとTypeは、管理画面での絞り込みやレポート集計の切り口として機能します。ブランドを横断して商品を扱う店舗ほど、入力規則を統一しておく価値が大きい列です。

Gift Card列は、商品がギフトカードかどうかをTRUEとFALSEで示す項目になります。通常商品ではFALSEのままにし、ギフトカードの新規作成はCSVから行えない仕様だけ覚えておけば困りません。

在庫・公開状態など挙動を左右する列

在庫を追跡する場合は、Variant Inventory Trackerに「shopify」と入力し、Variant Inventory Qtyへ在庫数を入れます。在庫切れ時の挙動はVariant Inventory Policyで決まり、「deny」なら販売停止、「continue」なら在庫ゼロでも販売継続という指定です。

受注生産や予約販売を扱う店舗では、continueの設定が役立つ場面もあります。ただし、在庫連動の体制が整っていない段階でcontinueにすると、売り越しによるキャンセル対応に追われかねません。

Publishedは公開状態を決める列で、TRUEで公開、FALSEで非公開という挙動です。空欄では公開扱いになるため、準備中の商品はStatus列で「draft（下書き）」を指定しておくと公開事故を防げます。

Statusに入る値は、公開のactive、下書きのdraft、アーカイブのarchivedという3種類です。シーズンオフ商品をarchivedへ退避させるといった使い分けも、CSVから一括で指定できます。

公開フラグの管理は、商品点数が増えるほど目視で追い切れません。CSVのStatus列で棚卸しすれば、公開漏れや非公開のまま放置された商品を一覧で洗い出せます。

Product Categoryには、Shopifyの標準商品分類に完全一致するパンくず形式の値を入れる決まりです。途中までの曖昧な表記だと「有効な商品カテゴリーではありません」というエラーが返ってきます。

Variant Fulfillment Serviceを空欄にするとエラーになる点も、見落としがちな注意点です。外部の出荷代行を使っていなければ、「manual」と入力すれば解決します。

在庫まわりの列は、登録後の在庫運用ルールとセットで考えるのが得策です。CSV上の数値をどの頻度で実在庫と突き合わせるかまで決めておけば、欠品や売り越しの予防にもつながります。

関連記事：Shopify在庫管理

ShopifyにCSVを一括インポートする手順5ステップ

ファイルの準備が整ったら、いよいよインポートの実行です。「操作を間違えて既存データを壊さないか不安」という担当者でも、画面の流れを押さえれば迷わず進められます。

作業は5つの手順に分かれ、慣れれば実操作は10分もかかりません。順番に確認していきます。

所要時間の目安は、100点規模で数分、1,000点規模なら数十分というレンジです。処理時間そのものより、前後の確認作業に時間を割く意識で臨むと精度が上がります。

CSVに商品情報を入力して保存する

最初の手順は、サンプルCSVを土台にした商品データの入力です。バリエーションや複数画像を持つ商品は複数行で表現するため、行数と商品数は必ずしも一致しません。

入力後は、ファイル形式がカンマ区切りのCSVで、文字コードがUTF-8かどうかを再確認します。Googleスプレッドシートからのダウンロードなら、2つの条件は自動的に満たされるため心配ありません。

管理画面の「商品管理」からインポートを開く

Shopify管理画面の左メニューで「商品管理」を開き、画面上部の「インポート」をクリックします。「商品をCSVファイルでインポートする」というポップアップが現れる流れです。

ポップアップ内のファイル選択エリアへ、作成したCSVをドラッグ＆ドロップします。「ファイルを追加する」ボタンから選択しても結果は変わりません。

上書きチェックボックスの扱いを判断する

アップロード画面には「一致するハンドルの商品を上書きします」というチェックボックスが表示されます。新規登録か既存更新かで扱いが正反対になる、最重要の設定項目です。

新規登録ならチェックを外しておくと、既存商品への意図しない上書きを防げます。逆に既存商品の更新が目的の場合、チェックを入れない限り該当行はスキップされてしまうでしょう。

「すべての販売チャネルに新しい商品を公開します」のチェックも見逃せません。外すとオンラインストアのみの公開に絞れるため、POSやSNS連携チャネルを持つ店舗では公開範囲の調整に使えます。

プレビューを確認してインポートを実行する

「アップロードとプレビュー」をクリックした後の画面が、実行前の最後の点検ポイントです。CSVの列とShopify側の項目が正しく対応しているか、文字化けがないかを必ず確認してください。

プレビューで見るべき点は、列の対応・日本語の表示・価格の桁の3つに絞られます。とりわけ列の対応ずれは全商品に影響するため、1項目ずつ目で追って確かめておきたい部分です。

問題がなければ「商品をインポートする」をクリックして実行に移ります。件数によって処理には数分から数十分かかるため、完了を待つ間は他の作業を進めて構いません。

処理の途中で別のCSVを重ねてインポートする操作は、競合の原因になるため避けるほうが無難です。1本の処理が完了したことを確かめてから、次のファイルに進んでください。

誤ったファイルを取り込んでしまった場合でも、処理の途中であれば停止の操作ができます。完了後に気づいたときは、事前に取得したエクスポートのバックアップから書き戻す対応です。

結果メールと商品一覧を確認する

処理が終わると、ストアの登録メールアドレスへインポート結果の通知が届きます。エラー発生時は該当行の番号と理由がメールに記載されるため、最初に確認すべき情報です。

一部の行だけエラーになった場合、正常な行は登録され、エラー行だけが除外されます。修正したCSVを作り直し、上書きチェックを入れて再インポートすれば穴埋めが完了する流れです。

結果メールには、登録に成功した件数とスキップされた件数も載っています。意図した件数との一致を照合しておくと、漏れの早期発見に役立つはずです。

仕上げに「商品管理」の一覧で、商品名・価格・画像が意図どおり登録されたかを目視で点検します。公開前の商品はプレビューで実際の見え方まで確かめると、公開後の修正が減るでしょう。

開店準備中のストアなら、商品登録と並行して決済・配送・ドメインなどの設定漏れも点検しておきたいところです。チェックリスト形式で順に潰していくと、オープン直前の慌ただしさを避けられます。

関連記事：Shopify初期設定チェックリスト

バリエーション・複数画像・コレクションを一括登録する応用テクニック

「単純な商品は登録できたのに、サイズ違いや色違いの書き方がわからない」という壁は、応用編で最初に立ちはだかる関門です。バリエーションや画像には商品CSV特有の行の組み方があり、知らないままでは先へ進めません。

押さえるべき考え方は「1商品＝1行」ではなく「1バリエーション・1画像＝1行」という構造です。仕組みを理解すれば、複雑な商品構成でも手が止まりません。

バリエーションは同じHandleの行を重ねる

サイズS・M・Lの3展開のTシャツなら、CSVは同じHandleを持つ3行で構成します。1行目に商品名や説明文などの基本情報をすべて入れ、2行目以降はHandleとバリエーション情報だけを書く形式です。

オプションの軸は、Option1 Nameに「サイズ」、Option1 ValueにS・M・Lの各値という対応で入力します。色とサイズのように軸が複数ある場合は、Option2やOption3の列で最大3軸まで広げられる構造です。

バリエーションごとの価格・SKU・在庫数は、各行のVariant系の列に入力します。同一商品内でオプション値の組み合わせが重複すると「オプションが固有ではありません」というエラーになるため、重複だけは事前に点検しておくと安全です。

在庫の保管場所（ロケーション）を複数登録しているストアでは、商品CSVのVariant Inventory Qty列が使えません。複数ロケーションの在庫数は、在庫専用のCSVで取り込む決まりです。

バリエーションのない商品では、Option1 Nameに「Title」、Option1 Valueに「Default Title」と入れる決まりもあります。サンプルCSVの見本行に同じ記述があるため、書き方に迷ったら見本を参照すると確実でしょう。

行の構成イメージとして、Handle列に「tshirt-a」が3行並び、Option1 ValueだけがS・M・Lと変わる形を思い浮かべてください。2行目以降のTitleや説明文が空欄でも、1行目の情報が商品全体に適用されます。

複数画像はURL指定の行を追加して登録する

CSVには画像ファイルそのものを添付できず、Image Src列へ画像URLを記載する方式です。先にShopify管理画面の「コンテンツ」→「ファイル」へ画像をアップロードし、発行されたURLをコピーして貼り付けます。

2枚目以降の画像は、HandleとImage Src、表示順を指定するImage Positionのみを入れた行で追加する決まりです。1行に書ける画像URLは1つだけで、Image Positionに1、2、3と番号を振ると番号順に並びます。

商品1点あたりの画像は、メイン1枚にサブ3〜5枚を加える構成が標準的です。角度違いや使用シーンの画像をImage Positionで並べ、購入判断に必要な情報を順に見せられます。

実務で効果が大きいのは、画像のファイル名を商品番号に統一しておくテクニックでしょう。アップロード後の画像URLには命名の規則性が生まれるため、表計算ソフトの文字列結合で数百枚分のURLを一括生成できたという実践報告もあります。

画像名がばらばらのままでは1枚ずつURLをコピーする羽目になり、画像登録だけで丸1日かかったという失敗談も現場の定番です。撮影データの納品時点でファイル名のルールを決めておくと、後工程の負担を大きく減らせます。

Image Alt Text列に入れるのは、画像の内容を説明する代替テキストです。視覚に頼らない閲覧環境への配慮に加えて画像検索からの流入経路にもなるため、商品名と特徴を組み合わせた短い説明を入れておくと無駄がありません。

バリエーションごとに画像を切り替えたい場合は、Variant Image列へ該当バリエーション用の画像URLを入れます。色違い商品で選択した色の画像へ自動で切り替わる動きは、Variant Imageの設定で実現する仕組みです。

画像URLは、httpまたはhttpsで始まる、誰でもアクセスできる直リンクでなければなりません。アクセス制限付きのURLやリンク切れのURLを指定すると、検証エラーで取り込みが止まってしまいます。

アップロード前に画像を適切なサイズへ圧縮しておくと、商品ページの表示速度にも良い効果が見込めるはずです。ページ表示の速さは離脱率や検索評価に響くため、登録前の一手間として組み込んでも損はありません。

コレクションはCollection列を自分で追加する

意外な落とし穴ですが、公式サンプルCSVはコレクション（商品のグループ）を指定する列を持たない構成です。コレクションへ入れたい場合は、「Collection」という列をCSVに手動で追加し、コレクション名を入力します。

CSVで指定できるコレクションは1商品につき1つだけで、エクスポート時にCollection列は出力されないという制約付きです。複数コレクションへの振り分けは、インポート後に管理画面側で整えるのが現実的でしょう。

存在しないコレクション名を書いた場合は、同名の手動コレクションが自動で作られます。条件で商品を集める自動コレクションに入れるには、商品側がタグなどの条件を満たしている必要がある点も覚えておくと混乱しません。

コレクションの構成は、トップページやナビゲーション導線の設計図と同じ役割です。CSVでの登録段階から「どの売り場に置く商品か」を意識しておくと、公開後のサイト整理で迷いません。

既存商品の一括更新とよくあるエラーの対処法

商品登録が一巡した後も、価格改定やセール準備、説明文の修正など、まとめて書き換えたい場面は定期的に訪れます。「更新のつもりが既存データを消してしまった」という事故は、CSV運用のトラブルで最も深刻な部類です。

安全に更新するための型と、エラーが出たときの対処パターンを押さえれば、CSVは日常運用の強力な道具になるでしょう。代表的な手順と頻出エラーを順に押さえておくと安心です。

更新前のエクスポートが最大の保険になる

既存商品を更新する際は、必ず先に「商品管理」の「エクスポート」で現状データをCSV出力しておきます。出力したファイルがそのままバックアップになり、失敗してもインポートし直せば元の状態へ戻せるからです。

編集は、エクスポートしたファイルの変更したい箇所だけに絞ります。商品を識別するキーであるHandleを書き換えると、更新ではなく別商品の新規作成として処理されるため、Handle列には触れないのが鉄則でしょう。

たとえばセールで対象商品の価格を10%下げる場合、エクスポート後にVariant Price列だけを修正し、上書きチェックを入れて再インポートする流れです。数百点の価格改定でも、表計算の数式を使えば30分程度で完了します。

インポート時に「一致するハンドルの商品を上書きします」へのチェックを忘れると、何も更新されないまま処理だけが終わってしまう点に注意してください。更新作業では、チェックボックスの確認を実行前の点検項目に固定しておくと確実です。

定期的にCSVを扱う店舗なら、週1回のエクスポートをバックアップ習慣にする運用も有効でしょう。直近の正常データが常に手元にある状態なら、どんな更新ミスも短時間で巻き戻せます。

バックアップは、日付入りの名前で3世代ほど残す管理が現実的です。容量は小さいため、保管の手間はほとんどかかりません。

更新履歴をファイルで残す習慣は、複数人運用での「誰がいつ何を変えたか」の記録にもなります。トラブル時の原因究明が速くなり、再発防止策も立てやすい体制です。

列を絞った部分更新CSVで事故を減らす

更新のたびに全列入りのCSVを扱うと、触るつもりのない列まで上書きされる危険が残ります。そこで役立つのが、HandleとTitle、変更対象の列だけを残した部分更新用CSVです。

商品CSVはHandleとTitleさえ残せば他の列を削除しても更新が通る仕様で、実務者の間では列を数本に絞った更新ファイルの運用が定着しつつあります。価格改定ならHandle・Title・Variant Priceの3列で済むため、確認すべき範囲が一気に狭まるでしょう。

ただし、Tags列を含めて更新する場合は要注意です。タグは追記ではなく丸ごと置き換えで処理されるため、既存のタグを残したいなら更新ファイル側にすべてのタグを書いておかないと消えてしまいます。

メタフィールドで他の商品を参照する高度な構成には、参照先が先に存在しないとエラーになるという制約付きです。最初にメタフィールドなしで商品を取り込み、2回目のインポートで参照情報を上書きする2段階方式なら回避できます。

代表的なエラーメッセージと解決策

エラーの大半は、メッセージさえ読み解ければ原因の特定が容易です。頻出パターンを知っておけば、復旧までの時間も数分で済みます。

文字化けや「行の不正な引用符」というエラーは、文字コードか引用符の問題です。UTF-8で保存し直すか、Excelが自動変換した曲がった引用符をまっすぐな半角の引用符へ置換すると解消します。

「無効なCSVヘッダー」が出たら、1行目の列名のつづりや不足を公式サンプルと突き合わせて確認してください。列名の末尾に紛れ込んだ余分なスペースが原因という例も珍しくありません。

「ハンドルがすでに存在するため行は無視されました」は、CSV内でHandleが重複しているサインです。「検証に失敗しました：価格を空白にできません」のように行番号付きで返るエラーは、該当行の空欄を埋めれば解決します。

画像関連のエラーで疑うべきは、URLの形式と画像サイズの2点です。公開された直リンクかどうか、5,000×5,000ピクセル以内かを確認すると、ほとんどの場合は原因が特定できるでしょう。

「在庫数量を空白にできません」「在庫数量が数字ではありません」という表示は、在庫列の入力漏れが原因です。在庫を追跡しない商品なら、Variant Inventory Trackerを空欄にしておけば回避できます。

「1日あたりのバリエーション作成数の上限に達しました」と出た場合の対処は、24時間待って残りを取り込む方法のみです。大規模ストア特有の制限のため、移行作業では日次1,000件のペース配分を前提に計画してください。

「フルフィルメントサービスを空白にできません」は、出荷手段の列の入力漏れを示すメッセージです。自社出荷の店舗なら、「manual」と入れるだけで解消する簡単なエラーといえます。

エラーが複数同時に出た場合は、行番号の小さい順ではなく、種類ごとにまとめて直すのが近道です。同じ原因のエラーは一括置換で同時に解消できるため、1件ずつ直すより手数が減ります。

どうしても解消しないときは、CSVを一度Googleスプレッドシートへ読み込み、再ダウンロードする方法が定番の最終手段です。ファイル形式の崩れがリセットされ、エラーが消えた例は枚挙にいとまがありません。

エラー対応に毎回数時間を取られている状態なら、作業フロー自体の見直しどきといえます。テンプレートの整備とテスト手順の標準化だけで、エラーの発生頻度は目に見えて下がるはずです。

CSV運用が軌道に乗ると、商品データの管理は「都度の作業」から「仕組み」へ変わります。空いた時間で商品ページの改善や販促に取り組める体制こそ、一括インポートの本当の成果です。

よくある質問

まとめ

Shopifyの商品CSVは、公式サンプルを土台にUTF-8で作成し、少量テストを挟んでからインポートする流れが王道といえます。HandleとTitleの2列を軸に、バリエーションや画像は同じHandleの行を重ねて表現すると覚えておけば、大半の登録作業で迷いません。

「バリエーションが多すぎてCSVの構成が組めない」「インポート後の商品ページの見せ方に自信がない」といったご相談があれば、ぜひお気軽にお問い合わせください。TSUMUGUでは、Shopifyの商品登録を含むストア運用の体制づくりを実務レベルで支援しています。→ まずは相談する（無料）