microCMS

コンテンツのCSVインポート

最終更新日:2025年05月23日

コンテンツをCSVファイルから一括で登録できる機能です。
他のCMSからコンテンツを移行するなど、一括でコンテンツを登録する際にお使いいただけます。

コンテンツの登録手順

新規登録の場合

1: 任意のAPIを作成します



2:[インポートする]ボタンを押します



3:サンプルのCSVファイル(input-format.csv)のリンクを押してダウンロードします

informationInformation

サンプルのCSVファイル(input-format.csv)では、登録されているフィールドの種類に応じてサンプル値が入力されていますので、インポートの際にご活用ください。


4:登録したいコンテンツを記入し、CSVファイルを更新・保存します



5:[ファイルを選択する]ボタンを押して、登録したいCSVファイルを読み込みます



6:インポートするコンテンツのステータスを選びます(下書き中 or 公開中)

informationInformation

ロール機能をご利用の場合、付与されている「コンテンツ」の権限に応じて、選択可能な項目が異なります。

  • 下書き中:新規コンテンツを下書き保存する権限を持つ場合に選択できます。
  • 公開中:新規コンテンツを公開する権限を持つ場合に選択できます。


7:[◯件のインポートを開始]ボタンを押します



8:インポート処理が実施されます。登録が完了するまでは、数分程度要する場合があります。

9:処理が正常に完了した場合は、「インポートが完了しました」というメッセージが表示され、コンテンツ登録が完了します。エラーが表示された場合は、エラーメッセージの内容を確認してください。

途中追加の場合

1: 任意のAPIを選択します
2:[インポートして追加]ボタンを押します



3:このあとは、新規登録の場合の手順3以降と同様の流れとなります

入力形式のルール

  • リスト形式のAPIのみご利用いただけます。
  • 非対応のフィールドがございます。

対応フィールドとその入力形式

フィールド名

入力形式

入力例 (*1)

テキストフィールド

任意のテキスト

テキスト

テキストエリア

任意のテキスト

複数行のテキストを入力

こんにちは

リッチエディタ

任意のテキスト (*2)

複数行のテキストを入力

こんにちは

旧リッチエディタ

任意のテキスト (*2)

複数行のテキストを入力

こんにちは

日時

ISO 形式 (ISO 8601)

2024-01-01T00:00:00Z

真偽値

TRUE または FALSE

TRUE

セレクトフィールド

選択肢として設定されている要素

選択肢1

セレクトフィールド(複数選択可)

選択肢として設定されている要素をカンマ区切りで指定

選択肢1,選択肢2

コンテンツ参照

参照先コンテンツのコンテンツID

category01

複数コンテンツ参照

参照先コンテンツのコンテンツIDをカンマ区切りで指定

category01,category02

数字

数字

100

  • (*1)テキストエディタなどからCSVファイルを編集する場合、入力値に改行やカンマ(,)を利用する際は、ダブルクォーテーション(")で囲む必要があります。
  • (*2)プレーンテキストでの登録のみ可能です。文字の装飾を付与した状態での登録はできません。

非対応のフィールド

  • 画像
  • 複数画像
  • ファイル
  • カスタム
  • 繰り返し
  • 拡張フィールド

制約事項

  • 一度にインポートできるコンテンツ数の上限は、プランによって異なります。詳細については、料金ページをご確認ください。

インポートのエラー

コンテンツのインポート時には、管理画面からデータを登録する場合と同様に、各入力項目に設定されたルール等に基づいて内容のチェックが行われます(バリデーション)。
インポート対象のコンテンツに1件でもエラーがある場合、その時点で処理は中断され、コンテンツは追加されません

よくあるエラーの例

CSVインポートに固有のエラー

各フィールドのバリデーションに加えて、CSVファイル内のデータに下記のような問題がある場合も、同様にエラーとなります。

  • CSVの列数とAPIスキーマのフィールド数が合わない
  • インポートするコンテンツの件数がプランの上限を超えている

その他の仕様

  • コンテンツIDは空白でも登録可能です(重複は不可)。
  • コンテンツの並び順については、CSVファイルの見た目通りに登録されます(2行目の記載内容が、管理画面の先頭に表示されます)。

参考情報

サービスにコンテンツを一括登録する方法として、CSVインポートの他にWRITE系APIによる登録もございます。
それぞれの特長や使い分けについては、以下のブログ記事にて詳しくご紹介していますので、ぜひご参照ください。

microCMSに大量コンテンツを登録する方法まとめ
https://blog.microcms.io/how-to-register-a-large-amount-of-content