Shopifyに商品を一括登録する方法

方法1：Shopify管理画面で商品CSVをインポートする

Shopifyの管理画面で「商品」を開き、「インポート」を選択します。Shopifyの商品形式のCSVをアップロードし、ハンドルが一致する商品を上書きするかどうかを選んで、プレビューを確認してから実行します。ファイルはバックグラウンドで処理され、完了すると通知が届きます。

• Shopifyの商品CSVのサンプルテンプレートから始めるか、既存の商品をエクスポートして正確な列を確認します。
• URL handle列（旧テンプレートではHandle）が商品を識別します。同じhandleを持つ行は、同じ商品のバリエーションまたは追加画像です。
• 主な列には、Title、Description（Body (HTML)）、Vendor、Product category、Type、Tags、Status、Option1 name / Option1 value、SKU（Variant SKU）、Price、Barcodes（Variant Barcode）、Product image URL（Image Src）があります。
• 画像は、インポート時に公開URLから取得されます。
• 特殊文字が崩れないよう、ファイルはUTF-8のCSVで保存してください。

バリエーションを正しく扱う

最初のインポートでは、多くの人がバリエーションでつまずきます。1つの商品には、最大3つのオプション（たとえばサイズ、色、素材）を設定できます。商品の最初の行には、商品レベルの項目とオプション名を入れ、同じハンドルを持つ続く各行が、オプション値、SKU、価格、在庫を持つバリエーションを1つずつ追加します。

オプション名は行をまたいで同一にし、各バリエーションのオプション値の組み合わせは一意にして、すべての行がちょうど1つのバリエーションに対応するようにします。バリエーション列はあるのにOption1 nameとOption1 valueがない行があると、Shopifyはデフォルトのバリエーションを作成し、既存のバリエーションを削除します。

方法2：一括インポートアプリ

Shopify App Storeのインポートアプリは、標準のCSV機能を拡張します。ExcelやGoogleスプレッドシートへの対応、メタフィールド、サプライヤーのフィードからのスケジュールインポート、他のプラットフォームからの移行などです。繰り返しインポートする場合や、標準のCSVでは扱えない項目が必要な場合に検討する価値があります。

方法3：Shopify Admin API

アプリやカスタム連携は、CSVファイルの代わりに、ShopifyのAdmin APIを通じて商品を作成できます。これによりスプレッドシートのやり取りが完全に不要になり、多くのカタログ・出品ツールがShopifyで商品を作成する方法です。

Doc2Shelfはこの方法を採用しています。OAuthでストアを接続し、確認済みの出品情報が、画像、価格、カテゴリーとともに下書き商品として作成されます。

Shopify向けの商品データの準備

一括アップロードの前に、次の点を確認してください。

• すべての商品に一意のハンドルを、すべてのバリエーションに一意のSKUを付けます。
• タイトルは一定のパターンに揃えます（例：ブランド＋商品名＋主要な属性）。
• 説明文はサプライヤーの文章をそのまま貼り付けず、自社の文章にします。HTMLはシンプルなものにします。
• 仕様の単位と名称を統一し、オプション、タグ、メタフィールドとして使えるようにします。
• 最初は非公開の状態でインポートし、公開する前にサンプルを確認します。

商品データがサプライヤーのPDFにある場合

CSVインポートは、整った構造化データがすでにあることを前提としています。サプライヤーが仕様書やカタログをPDFで送ってくる場合は、まず誰かがタイトル、仕様、識別子を抽出し、説明文を書く必要があります。これがたいてい作業全体で最も時間のかかる部分です。

Doc2Shelfはこの工程を置き換えます。サプライヤーのPDFを読み取り、確認用の信頼度情報とともに商品データを抽出し、Shopifyの出品用文章の下書きを作成し、確認済みの商品を、CSVを使わずに、接続したストアに下書きとして作成します。

Shopify商品CSVの列：現在の名称と旧名称の対応

Shopifyは、商品CSVのいくつかの列名を変更しました。現在のCSVリファレンスでは、URL handle、Description、SKU、Barcodesといったラベルが使われていますが、多くのテンプレートやチュートリアルでは、依然としてHandle、Body (HTML)、Variant SKU、Image Srcが紹介されています。Shopifyは旧列名との後方互換性を維持しているとしているため、古いファイルでもインポートできます。ただし、新たにエクスポートするファイルは現在のラベルを使い、両方の表記が混在したファイルは確認しにくくなります。

この表は、一括登録で必要になることが多い列を扱っています。BarcodeからBarcodesへの名称変更はShopifyのドキュメントに明記されていますが、その他の旧ラベルは各項目の内容から対応付けたものです。ご自身のストアからのエクスポートと照合して確認してください。ヘッダーは大文字と小文字が区別されます。

バリエーションとオプション：制限と落とし穴

Shopifyの商品には、最大3つのオプション（たとえばSize、Color、Material）と、最大2,048のバリエーションを設定できます。バリエーションの上限は、2025年10月にShopifyが引き上げるまで100でした。そのため、それ以前に書かれたテンプレートやガイドには、今も古い数字が載っています。一部のテーマ、アプリ、販売チャネルは古い上限を前提に作られているため、数百のバリエーションを持つ商品をインポートする前に、お使いのものを確認してください。

商品の最初の行には、商品レベルの項目とオプション名を入れます。同じURL handleを持つ後続の各行は、オプション値、SKU、価格、重量、在庫を持つバリエーションを1つ追加し、商品レベルの項目は空にします。

更新のインポートでは、2つの挙動に注意が必要です。SKUや重量などのバリエーション列を含む行でOption1 nameとOption1 valueを省略すると、Shopifyはデフォルトのバリエーションを作成し、既存のバリエーションを削除します。また、オプション値を変更すると（たとえば「Grey」を「Gray」に変更）、バリエーションIDが削除されて新しいIDが作成されるため、それらのIDを参照しているアプリやフィードが動かなくなる場合があります。

ShopifyのCSVでの商品画像

Shopifyはインポート時に、Product image URL列から画像をダウンロードするため、各URLは公開されていて、画像ファイルを直接指している必要があります。ログインが必要なリンク、プレビューページが開くリンク、インポートの実行前に有効期限が切れるリンクは、画像が取り込まれない典型的な原因です。

1つの商品には、最大250枚の画像またはその他のメディアを設定できます。最初の画像は商品の最初の行に入れ、それ以降の画像は、同じURL handle、画像URL、Image position、Image alt textを持つ独立した行に追加します。買い物客がバリエーションを選んだときに特定の画像を表示するには、そのバリエーションの行のVariant image URLにURLを入れます。

代替テキストは512文字まで設定でき、Shopifyは125文字以内を推奨しています。商品タイトルの繰り返しではなく、画像に写っているもの（「ステンレス製ケトル、水量計付きの正面」など）を記述します。

商品カテゴリー、メタフィールド、Standard Product Taxonomy

Product category列では、商品の主な機能に基づいて、ShopifyのStandard Product Taxonomyからカテゴリーを割り当てます。完全な階層表記（例：Home & Garden > Linens & Bedding > Bedding > Bed Sheets）か、カテゴリーID（例：hg-15-1-2）のどちらかを入力します。両方は入力しません。カテゴリーのない商品は、未分類として扱われます。

カテゴリーを設定すると、そのカテゴリーメタフィールドが利用できるようになります。分類体系ではこれを商品属性と呼びます。たとえばShopifyのShirtsカテゴリーには、size、neckline、fabric、colorなど9つがあり、colorの値はスウォッチとして表示できます。Option1 LinkedTo列は、バリエーションオプションを、これらのカテゴリーメタフィールドのいずれかに紐づけます。

カテゴリーはナビゲーションにとどまらず、Shopify Taxが税率を設定する際にも利用されます。一方、Typeは自分で定義する自由形式のラベルで、自社のフィルターやレポートに役立ちます。

カスタム商品メタフィールドは、Name (product.metafields.namespace.key)という見出しの列でインポートします（例：Material (product.metafields.custom.material)）。バリエーションのメタフィールドは商品CSVではサポートされていないため、管理画面、アプリ、またはAPIで設定してください。

ShopifyのCSVの制限とSEO項目の文字数

ここに示すのは、Shopifyが商品CSVのインポートと商品レコードについて公開している制限です。古いガイドに載っている数値（特に100バリエーションという上限）は、すでに古くなっています。

SEO titleとSEO descriptionの列には、検索結果に表示されるタイトルとメタディスクリプションを入力します。カタログ全体に同じパターンをコピーするのではなく、商品ごとに書いてください。商品名と、サイズ、素材、型番など、買い物客が検索する属性を先頭に置きます。

上書きか新規作成か：更新時の挙動

商品を作成するだけなら、CSVに必要なのはTitleだけです。バリエーションを追加する場合は、URL handleも必要です。既存の商品を更新するには、URL handleとTitleが必要で、インポートの開始時に、handleが一致する商品を上書きするかどうかを選択します。

上書きは、含めたすべての列について確定的なものとして扱ってください。最も安全な手順は、エクスポート、編集、再インポートです。変更したい商品をエクスポートし、変更が必要なセルだけを編集し、オプションの列はそのまま残し、上書きをオンにして編集したファイルをインポートします。ゼロから作った情報の少ないファイルでは、上で説明したバリエーションの削除が起きやすくなります。

確定する前にインポートのプレビューを確認し、大規模な更新は、まず数点の商品で試してください。編集前に作成したエクスポートが、問題が起きたときに元に戻す手段になります。

インポート前のチェックリストとトラブルシューティング

大規模なインポートの前に、次の手順を順に確認してください。その後の表は、特によくある問題を扱っています。

1. ストアから商品を1つエクスポートし、そのヘッダー行を再利用して、列名が完全に一致するようにします。
2. すべての商品に一意のURL handleを、すべてのバリエーションに一意のSKUを付けます。
3. オプション名と値の表記が一貫しているかを確認し、すべてのバリエーション行にオプション値があることを確認します。
4. Product categoryには、分類体系からコピーした階層表記またはIDを入力します。
5. 画像URLのサンプルをプライベートブラウジングのウィンドウで開き、ログインなしで読み込めることを確認します。
6. 最初の実行では、Statusをdraftに設定します。
7. UTF-8のCSVとして保存し、ファイルが15 MB未満であることを確認します。
8. まず5〜10点の商品をインポートし、管理画面とストアフロントで確認してから、残りをインポートします。