CSVファイルを使用した商品のインポートとエクスポート
CSV (カンマ区切り値) ファイルを使用して、Shopifyストアに商品をインポートしたり、ストアから商品をエクスポートしたりできます。CSVファイルを使用すると、多数の商品とその詳細を同時にインポートまたはエクスポートできます。これは、Shopifyと他のプラットフォーム間で商品情報を交換する場合に役立ちます。
CSV ファイルの使用方法に関する詳細については、CSV ファイルを開いて編集するを参照してください。
このページの内容
サンプルCSVファイルをダウンロードする
テンプレートとして使用できるサンプル商品 CSV ファイルをダウンロードして、内容を確認できます。サンプルファイルを使用する場合は、以下の点にご注意ください。
- サンプルファイルには、2つの商品例といくつかのバリエーションが含まれています。インポートファイルには、より多くの商品とバリエーションが含まれる可能性があります。サンプルファイルを使用して独自のインポートファイルを作成する場合は、すべての商品例を必ず削除してください。
- サンプルファイルには、 Inventory quantity 列が含まれています。これは、単一のロケーションを持つストアでのみ使用されます。複数のロケーションを使用していて在庫数量をインポートまたはエクスポートする場合は、在庫 CSV ファイルを使用してください。
- サンプルファイルには、Price / International 列と Compare-at price / International 列が含まれていますが、海外で販売されるサンプル商品には固有の価格設定がないため空欄になっています。海外 CSV 列に関する詳細情報をご確認ください。
商品CSVファイルに関する考慮事項
商品CSVファイルを使用する前に、以下の考慮事項を確認してください。
商品CSVファイルのフォーマット
商品CSVファイルが正しく機能するように、以下の基準を満たしていることを確認してください。
- 商品 CSV ファイルの最初の行は、商品 CSV の説明表で指定されている列ヘッダーにする必要があります。
- 各列はカンマで区切る必要があります。
商品CSVファイルの必須列
以下の条件では、これらの列が存在する必要があります。
- 新しい商品をインポートするために商品 CSV ファイルを作成する場合、必須の列は Titleのみです。商品にバリエーションを追加する場合は、 URL handle 列も必須です。
- CSV ファイルを使用して商品を更新する場合、必須の列は URL handle と Titleです。
データの依存関係
CSV ファイルで商品を更新する際に必須なのは Title と URL handle の列だけですが、一部の列のデータは他の列のデータに依存します。
たとえば、バリエーションに関連する列 ( SKU や Weight value (grams)など) を更新する場合、それらの列のデータは、対応するバリエーションのデータに依存します。この場合、 Option1 name と Option1 value 列も含める必要があります。
海外CSV列
ストアでマーケットを設定している場合、CSV エクスポートには、作成した固有のマーケットが反映されます。デフォルトで、CSV には以下の列が含まれます。
Included / [Primary]([Primary]は、ご利用のプライマリーマーケットの名前に置き換えられます)含まれる / 海外Price / International価格の比較 / 海外
海外マーケットを独自のマーケットに置き換える場合、ヘッダー名の海外はマーケットの名前に変更されます。
たとえば、大陸ごとにマーケットを作成し、マーケット名の1つが南米である場合、CSVエクスポートファイルの列ヘッダーは次のように調整されます。
含まれる / 海外が含まれる / 南米になりますPrice / InternationalはPrice / South AmericaになりますCompare-at price / InternationalはCompare-at price / South Americaになります
CSV列のメタフィールド
CSV ファイルを使用した商品の一括インポート/エクスポートでは、商品のメタフィールドがサポートされています。商品のメタフィールドが定義されると、そのメタフィールドは商品 CSV のエクスポートに含まれます。列ヘッダーの形式は、<name> (product.metafields.<namespace>.<key>) です。product.metafields.<namespace>.<key> を使用することもできます。たとえば、Fabric (素材) のメタフィールドの形式は、Fabric (product.metafields.shopify.fabric)、または名前とかっこを除いた product.metafields.shopify.fabric のようになります。メタフィールドのネームスペースとキーは、[設定] > [カスタムデータ] > [商品] > [メタフィールド] で確認できます。商品のメタフィールドに関する詳細情報をご確認ください。
オプション値は、商品CSVのインポート/エクスポートでもサポートされています。オプションのリンク先列を使用して、オプションをメタフィールドに接続します。その後、それぞれのオプション値列でメタオブジェクト値を使用できます。
バリエーションのメタフィールド
バリエーションのメタフィールドは、商品 CSV のインポート/エクスポートでサポートされていません。バリエーションのメタフィールドを一括で編集するには、バリエーションの一括編集を使用してメタフィールド列を追加する必要があります。バリエーション詳細の一括編集に関する詳細はこちらをご覧ください。
商品CSVファイルの列の説明
次の表は、商品CSVで使用できるすべての列の概要です。
に加えて、 Title 列に加えて、他のいくつかの列にも値を入力する必要があります。必須の列は、以下の表に記載されています。これらの列が空欄であったり、CSV ファイルから省略されたりした場合は、デフォルト値が作成されます。
商品CSVファイルの列
| 列 | 説明 (空のセルに対するデフォルトの動作を含む) |
|---|---|
| Title | お客様に表示する商品名です。たとえば、 Women's Snowboardです。 |
| URL handle | 各商品の固有IDです。ハンドルは商品ページの URL に使用され、その値の基準となるのは Title 列の値に基づいています。たとえば、 Title 列の値が Black Sunglassesの場合、 URL handle 列の値が black-sunglasses がデフォルトで設定されます。商品ページの URL を商品名とは異なるものにする場合は、URLハンドルの値をカスタマイズできます。有効なURLハンドルには、文字、ダッシュ、数字を含めることができますが、スペースを含めることはできません。 |
| Description | 商品がどのようなものかの詳細を提供する、商品の説明です。 |
| Vendor | 販売する商品の仕入れ元または供給元の名前です。商品を自作している場合、販売元の列の値は、Shopifyにログインする際に使用するストア名と同じになります。
販売元情報の管理についてご確認ください。 |
| Product category |
商品のタイプを説明するラベルで、アメリカでの税率を計算するために使用されます。ラベルはShopify の標準的な商品分類から選択する必要があります。 有効な標準化された商品カテゴリーは、以下で識別できます。
|
| Type |
Shopify の標準カテゴリーに加えて、商品を整理するためのカスタムカテゴリーが必要な場合に商品を説明するラベルです。たとえば、商品カテゴリーが 商品タイプの追加について、詳しくはこちら。 |
| Tags |
お客様がオンラインで商品を見つけやすくするため、または商品をグループ化して絞り込むために、キーワードを追加します。
ほとんどのスプレッドシートアプリでは、タグが自動的に引用符で囲まれます。プレーンテキストエディタを使用する場合は、手動で引用符を追加する必要があります。例: タグの形式について、詳しくはこちら。 |
| Published on online store |
商品をオンラインストアの販売チャネルで公開するかどうかを指定します。有効な値は次のとおりです。
オンラインストアへの公開について、詳しくはこちら。 |
| Status |
お客様が商品を購入できるかどうかを示します。この列が存在する場合は、値を入力する必要があります。この列が存在しない場合、商品のステータスは自動的に次のようにアップロードされます。
商品のステータスについて、詳しくはこちら。 |
| SKU |
在庫を追跡するために使用される、バリエーションの最小管理単位 (SKU) です。カスタムフルフィルメントサービスを使用する場合、SKU 列を空白にすることはできません。 |
| Barcode |
バリエーションのバーコード、国際標準図書番号 (ISBN)、または国際商品コード (UPC)。 在庫コードについて、詳しくはこちら。 |
| Option1 name |
サイズや色など、複数のオプションがある商品のバリエーションを作成するには、その名前を入力します。商品のオプション名の値の組み合わせは、それぞれが商品のバリエーションになります。例: 1つの商品に最大3つのオプションを設定できます。 商品にオプションが1つしかない場合、この値は次のようにする必要があります。 バリエーションの作成について、詳しくはこちら。 |
| Option1 value |
サイズや色など、商品に複数のオプションがある場合は、その値を入力します。たとえば、色オプションの値には次のようなものがあります。 列でカテゴリーメタフィールドにリンクする場合、 注意:この列のデータを変更すると、既存のバリエーションIDの値が削除され、新しいバリエーションIDが作成されます。バリエーションIDの値を変更すると、バリエーションIDに対する外部サービスの依存関係が壊れる可能性があります。 商品のバリエーションの作成について、詳しくはこちら。 |
| Option1 LinkedTo | 商品オプションがカテゴリーメタフィールドに接続されている場合、この値は次のようにする必要があります。 product.metafields.shopify.{taxonomy_attribute} |
| Price |
商品またはバリエーションの価格です。通貨記号を付けずに金額のみを入力してください。例: 商品の価格について、詳しくはこちら。 |
| Price / International |
同じ名前のマーケットで、そのマーケットの通貨で商品の定価を設定します。 海外販売用の CSV 列について、詳しくはこちら。 |
| Compare-at price |
価格が引き下げられ、価格の比較を表示する場合のバリエーションの元の価格です。通貨記号を付けずに金額のみを入力してください。例: 割引前価格の設定について、詳しくはこちら。 |
| Compare-at price / International |
同じ名前のマーケットで、そのマーケットの通貨で商品の定価の比較を設定します。マーケット内の商品の定価の比較を使用するには、定価が必要です。 海外販売用の CSV 列について、詳しくはこちら。 |
| Cost per item |
商品またはバリエーションの製造または取得にかかる費用。通貨記号なしで金額のみを入力してください。たとえば、「 商品あたりの費用の設定について、詳しくはこちら。 |
| Charge tax |
商品が課税対象の場合は、ロケーションベースの税金を設定します。有効な値は次のとおりです。
|
| Inventory tracker |
バリエーションの在庫を追跡するために使用するサービスを指定します。有効な値は次のとおりです。
既存の在庫追跡オプションを削除すると、在庫は追跡されなくなります。 外部のフルフィルメントサービス: 外部サービスのフルフィルメントサービスに保管されているバリエーションの場合、エクスポートされた CSV では |
| Inventory quantity |
商品またはバリエーションの在庫数。これは、単一ロケーションのShopifyストアにのみ適用されます。 デフォルト値は 販売可能な在庫の管理について、詳しくはこちら。 |
| Continue selling when out of stock |
在庫切れの商品をお客様が購入できるようにするかどうかを指定します。有効な値は次のとおりです。
在庫切れ商品の販売について、詳しくはこちら。 |
| Weight value (grams) |
商品またはバリエーションの重量 (グラム単位)。 測定単位や小数点を含めず、数値のみを指定する必要があります。たとえば、バリエーションの重量が次の場合です。
5.125 kgの場合、次のように入力します。 デフォルト値は 配送料の自動計算または外部フルフィルメントサービスを使用する場合は、正確な重量を使用してください。 |
| Weight unit for display |
ストアに商品の重量を表示する際に使用する測定単位。 有効な値は、次のとおりです。
|
| Requires shipping |
商品が (たとえばデジタルではなく) 物理的な商品であり、発送が必要かどうかを示します。有効な値は、次のとおりです。
発送の詳細について、詳しくはこちら。 |
| Fulfillment service |
商品またはバリエーションに使用するフルフィルメントサービス。有効な値は、次のとおりです。
カスタムフルフィルメントサービスを使用する場合は、次のガイダンスに従って、この列にサービスの名前を入力します。
たとえば、フルフィルメントサービスの名前が「Joan's Fulfillment」の場合、CSV ファイルに この列にサービス名を追加する前に、Shopify の管理画面でカスタムフルフィルメントサービスを設定しておく必要があります。 外部のフルフィルメントサービス: 外部サービスのフルフィルメントサービスに保管されているバリエーションの場合、エクスポートされた CSV では CSV をインポートする際、この列を特定のフルフィルメントサービスのハンドル (たとえば |
| Included / [Primary] |
海外で販売する場合、この列は、商品が主要マーケットでの販売対象に含まれるかどうかを示します。デフォルト値は この列見出しの名前は、Internationalで主要マーケットとして決定された国や地域によって異なります。デフォルトの主要マーケットを変更すると、列ヘッダーに新しいマーケット名が表示されます。詳細については、考慮事項のセクションを参照してください。 |
| Included / International |
海外で販売する場合、この列は、商品が海外マーケットで販売可能かどうかを示します。デフォルト値は この列見出しの名前は、ストアで設定したInternationalによって異なります。デフォルトのマーケットは |
| Product image URL |
商品画像のURLを入力します。Shopifyはインポート中に画像をダウンロードし、ストアに再アップロードします。 画像ファイル名が次のようになっていることを確認します。
この列はバリエーションに固有のものではありません。バリエーション画像を追加するには、バリエーション画像列を使用してください。 |
| Image position |
商品ページに画像を表示する順序を表す番号を入力します。画像は、画像位置の値 |
| Image alt text |
代替 (alt) テキストは、画像とそれが表す商品を説明するものです。何らかの理由でブラウザに画像を読み込めない場合、代わりに代替テキストが表示されます。また、たとえば、スクリーンリーダーを使用する視覚に障碍のあるお客様に画像を説明するために、支援技術によっても使用されます。代替テキストを含めると、ウェブサイトのSEOを向上させることができます。 代替テキストは簡潔で説明的にしてください。
|
| Variant image URL |
バリエーション画像のURLを入力します。追加したURLが機能する画像URLであることを確認してください。 |
| Gift card |
商品がギフトカードであるかどうかを示します。有効な値は、次のとおりです。
この列では、他のギフトカードの詳細も一括編集できます (例: |
| SEO title |
検索エンジンの結果に表示される商品名。入力するSEOタイトルは、英数字で最大70文字まで入力できます。有効なSEOタイトルは、次のとおりです。
この列を空白のままにした場合、商品の Title が、商品の検索エンジンリスティングページのタイトルとして使用されます。 SEOタイトルを編集することについて、詳しくはこちら。 |
| SEO description |
SEOメタディスクリプションは、商品の詳細ページの[検索結果のプレビュー] ヘッダーの[説明] にもあります。入力するSEOメタディスクリプションは、英数字で最大320文字まで入力できます。 この列を空白のままにした場合、商品の Description が使用されます。 |
| Google Shopping / Google Product Category |
現在Google商品カテゴリーを使用している場合は、それをShopify商品カテゴリーとして使用できます。商品カテゴリー、Google商品カテゴリー、またはその両方を使用できます。各アイテムに可能な限り最も具体的なカテゴリーを指定してください。 Google商品カテゴリー (GPC) (google_product_category) は、Googleの商品分類を使用します。 Google商品カテゴリーは、次のいずれかの方法で入力できます。
|
| Google Shopping (Unstructured metafield) |
列のヘッダーは、含まれている値が表すGoogleショッピングのメタフィールドによって異なり、先頭に
Googleショッピングの列は、アプリが商品をGoogle Merchant Centerに同期するために使用する場合があります。ただし、GoogleおよびYouTubeチャネルでは、これらのメタフィールドは使用されません。アプリから使用するように指示されない限り、名前に「Googleショッピング」が含まれるメタフィールドの列にある値は無視してかまいません。 |
| Metafields |
これらの商品メタフィールドはストアで作成されます。商品メタフィールドの定義は、列ヘッダーに
|
インポートCSVファイルによる商品の詳細の上書き
CSVファイルをインポートする際に、[一致するハンドルを持つ商品を上書きする] オプションを選択できます。このオプションを選択した場合、インポートするCSVファイルのハンドルが商品リスト内の既存のハンドルと一致すると、CSVファイルの値によって既存の商品リスト内の一致する列の値が上書きされます。上書きオプションが選択されていない場合、既存のハンドルと一致する商品はCSVのインポート中に無視されます。
- インポートするCSVファイルの必須でない列が空白の場合、商品リスト内の一致する値は空白で上書きされます。
- たとえば、 Vendor の商品リストに既存の値が
John's Apparelであっても、 Vendor 列がインポートするCSVファイルで空白になっている場合、John's Apparelの値は空白で上書きされます。
- たとえば、 Vendor の商品リストに既存の値が
- 必須ではない列がインポートCSVファイルに含まれておらず、既存の商品リストに含まれている場合、商品リストの値は変更されません。
- たとえば、 Variant image URL 列が既存の商品リストに含まれていても、その列がインポートCSVファイルに含まれていない場合、商品リストの値は変更されません。
- インポートするCSVファイルに、ファイルに含まれていない他の列データに依存する必須でない列が含まれている場合、既存のデータは削除されます。
- たとえば、インポートするCSVファイルにSKU列が含まれていても、Option1 value列とOption1 name列が含まれていない場合、商品バリエーションのオプションは削除されます。
- CSVファイルを使用して商品を一括削除することはできません。商品を一括削除する場合、管理画面の [商品管理] セクションで一括操作を使用できます。
- CSVファイルを使用して、他の販売チャネルでの商品の出品状況を一括で更新することはできません。他の販売チャネルで商品の出品状況を設定することについて、詳しくはこちら。
Collection列の例外
CSVファイルのアップロード時に商品をコレクションに分類するには、CSVファイルの任意の場所に、ヘッダー名が Collectionです。
CSVファイルをエクスポートする際に、 Collection 列は含まれません。
| 列 | 説明 |
|---|---|
| Collection |
この商品を追加するコレクションの名前を入力します。
商品を1つのコレクションにのみ追加できます。 この値は空白にすることができます。 最大長は255文字です。 既存の商品を上書きすることによって、この列のデータがどのように影響を受けるかについて、詳しくはこちら。 |
商品CSVファイルの作成
各商品について、それが単一商品か、バリエーションのある商品かを判断する必要があります。
- 単一商品: 単一商品にはバリエーションは含まれません。バリエーションのない商品をアップロードする場合は、最初の行に商品のすべてのフィールドと最初の画像のURLを入力します。次の行以降は、追加の画像ごとにハンドルとURLのみを入力します。
- バリエーションのある商品:バリエーションのある商品をアップロードする場合、1行目に最初の商品画像のURLとともに、その商品のすべてのフィールドを入力します。次の行以降には、URLハンドルを入力します。その後、 Title、 Description、 Vendor、および Tags 列をスキップします。残りのバリエーションの詳細と各画像のURLを入力します。
すべての商品と画像を追加したら、LF形式の改行コードを使用して、CSVファイルをUTF-8形式で保存します。エンコーディングに詳しくない場合は、スプレッドシートやテキストエディタプログラムのドキュメントを確認してください。
CSVファイルの例を表示するには、こちらのサンプル商品CSVファイルをダウンロードし、Googleスプレッドシートなどのスプレッドシートプログラムで開いてください。
画像を準備する
CSVファイルにはテキストしか含めることができないため、すべての商品画像が既存のウェブサイト上にあることを確認する必要があります。これらの画像URLは、CSVファイルのインポートプロセス中にのみ使用されます。インポートが完了したら、URLを削除できます。
CSVファイルでは、画像URLのみを使用できます。3Dモデルと動画はCSVでサポートされていませんが、[コンテンツ] > [ファイル] からアップロードできます。商品メディアのタイプについて、詳しくはこちら。
外部ソースからの画像URLは、一般公開されている必要があります。[コンテンツ] > [ファイル] に画像をアップロードすると、すべての商品画像が正確であることを確認できます。
画像ファイルのロケーションに応じて、次のいずれかのアクションを実行します。
- ファイルがコンピューターにのみ保存されている場合は、[コンテンツ] > [ファイル] でShopifyストアにアップロードするか、GoDaddy、OneDrive、Dropbox、BucketLynxなどの別の画像ホスティングサービスにアップロードしてから、そのURLを取得する必要があります。
- 別のプラットフォームからShopifyに切り替える場合は、現在の画像URLをコピーしてCSVファイルで使用できます。
- 商品CSVファイルが、Shopifyから商品をエクスポートして作成されたものである場合、画像はすでにウェブサイトにアップロードされているため、何もする必要はありません。
各商品画像のURLを用意したら、CSVファイルの作成を開始できます。
CSVファイルへの複数の商品画像の追加
Shopifyの管理画面に画像をさらにアップロードすることで、CSVファイルに商品画像を追加できます。CSVファイルを使用してShopifyストアを構築している場合、そのプロセスは少し異なります。以下の考慮事項を確認してください。
- CSVファイルを編集できる必要があります。Shopifyでは、フォーマットされたバージョンのCSVファイルを表示するために、Googleスプレッドシートを使用することをおすすめします。
- 1つの商品に最大250件の画像を追加できます。
- 商品画像は、一般公開されているURLにアップロードする必要があります。つまり、パスワードで保護されておらず、
https://プロトコルを使用している必要があります。そのためには、Shopifyの管理画面の[ファイル] ページに画像をアップロードします。URLは自動的に生成されます。[ファイルをアップロード] をクリックすると、最大で数百枚の画像をまとめてアップロードできます。
CSVファイルに複数の商品画像を追加する
- 新しい行を挿入します。画像ごとに1つの行のみを使用する必要があります。
- ハンドルをコピーして貼り付けます。
- 画像のURLをコピーして貼り付けます。
新しい行を挿入
- GoogleスプレッドシートなどのスプレッドシートプログラムでCSVファイルを開きます。
- 画像を追加する商品を検索します。
- 次の行で、行番号をクリックしてドラッグし、複数の行を選択します。追加する画像の数と同じ数の行を選択します。

- それらの行をハイライト表示した状態で、ハイライトされた領域の任意の場所を右クリックし、 上にX行を挿入。
![商品CSVのGoogleスプレッドシートで、[上に2行を挿入] オプションが選択されています。](https://cdn.shopify.com/shopifycloud/help-center/manual/products/csv-img-3.png)
URLハンドルの値をコピーして貼り付ける
新しい行のA列に、必要な商品のURLハンドルの値をコピーして貼り付けます。

画像のURLをコピーして貼り付ける
- [ファイル] ページで、画像をShopifyにアップロードします。
- 次をクリックします。 リンクをコピー アイコンを一度に1つの画像URLに対してクリックします。
![Shopifyの管理画面の [ファイル] ページで、黒いTシャツの画像の行にあるリンクボタンがハイライトされています。](https://cdn.shopify.com/shopifycloud/help-center/manual/products/csv-img-6.png)
- スプレッドシートアプリケーションのCSVファイルで、CSVファイルの最後の列まで横にスクロールします。
- ...で Product image URL 列で、各行に画像のURLを貼り付けます。
![商品CSVのGoogleスプレッドシートで、黒いTシャツの商品画像のURLが [画像ソース] 列の行に入力されています。](https://cdn.shopify.com/shopifycloud/help-center/manual/products/csv-img-5.png)
- この商品のすべての画像について、手順2~4を繰り返します。
- 任意:SEOを向上させるには、すべての Image alt text フィールドに値を入力します。画像のaltテキストについて、詳しくはこちら。
- CSVファイルを保存し、Shopifyにインポートします。