コンテンツをCSVファイルから一括で登録できる機能です。
他のCMSからコンテンツを移行するなど、一括でコンテンツを登録する際にお使いいただけます。
１： 任意のAPIを作成します
２：［インポートする］ボタンを押します
３：サンプルのCSVファイル（input-format.csv）のリンクを押してダウンロードします
サンプルのCSVファイル（input-format.csv）には、登録されているフィールドの種類に応じてサンプル値が入力されています。インポートの際にご活用ください。
４：登録したいコンテンツを記入し、CSVファイルを更新・保存します
５：［ファイルを選択する］ボタンを押して、登録したいCSVファイルを読み込みます
６：インポートするコンテンツのステータスを選びます（下書き中 or 公開中）
ロール機能をご利用の場合、付与されている「コンテンツ」の権限に応じて、選択可能な項目が異なります。
7：［◯件のインポートを開始］ボタンを押します
８：インポート処理が実施されます。登録が完了するまでは、数分程度要する場合があります。
９：処理が正常に完了した場合は、「インポートが完了しました」というメッセージが表示され、コンテンツ登録が完了します。エラーが表示された場合は、エラーメッセージの内容を確認してください。
１： 任意のAPIを選択します
２：［インポートして追加］ボタンを押します
３：このあとは、新規登録の場合の手順3以降と同様の流れとなります
コンテンツのCSVエクスポートで出力したCSVファイルを利用して、コンテンツを登録できます。
CSVファイルのエクスポート方法は「コンテンツのCSVエクスポート」をご参照ください。
1：エクスポートしたCSVファイルからid以外の共通カラムを削除して保存します。
２：このあとは、新規登録の場合の手順5以降と同様の流れとなります
エクスポートしたCSVファイルをインポートする際、以下のようなケースでは、インポートできない場合があります。
フィールド名 | 入力形式 | 入力例 (*1) |
|---|---|---|
テキストフィールド | 任意のテキスト | テキスト |
テキストエリア | 任意のテキスト | 複数行のテキストを入力 こんにちは |
リッチエディタ | HTML文字列 (*2) | <p>複数行のテキストを入力<br />こんにちは</p> |
旧リッチエディタ | 任意のテキスト (*3) | 複数行のテキストを入力 こんにちは |
画像 | microCMSで配信されている画像のURL (*4) | https://images.microcms-assets.io/assets/xxxx/yyyy/sample.png |
複数画像 | microCMSで配信されている画像のURLをカンマ区切りで指定 (*5) | https://images.microcms-assets.io/assets/xxxx/yyyy/sample1.png, |
日時 | ISO 形式 (ISO 8601) | 2024-01-01T00:00:00Z |
真偽値 | TRUE または FALSE | TRUE |
セレクトフィールド | 選択肢として設定されている要素 | 選択肢1 |
セレクトフィールド（複数選択可） | 選択肢として設定されている要素をカンマ区切りで指定 | 選択肢1,選択肢2 |
コンテンツ参照 | 参照先コンテンツのコンテンツID | category01 |
複数コンテンツ参照 | 参照先コンテンツのコンテンツIDをカンマ区切りで指定 | category01,category02 |
数字 | 数字 | 100 |
カスタム | JSON（登録可能なキーのみ）(*7) | {"fieldId":"xxxxxxxx","some_value": "xxxxxxxx"} |
繰り返し | JSON配列（登録可能なキーのみ）(*7) | [{"fieldId":"xxxxxxxx","some_value": "xxxxxxxx"},{"fieldId":"xxxxxxxx","some_value": "xxxxxxxx"}] |
ファイル (*6) | microCMSで配信されているファイルのURL | https://files.microcms-assets.io/assets/xxxx/yyyy/manual.pdf |
拡張フィールド | JSON（登録可能なキーのみ）(*7) | {"id":"xxxxxxxx", "title":"xxxxxxxx", "description":"xxxxxxxx", "imageUrl":"https://images.microcms-assets.io/assets/xxxxxxxx/yyyyyyyy/sample1.png", "updatedAt":"2025-01-01T00:00:00.000Z","data":{"id": "123"}} |
"は""で登録する必要があります。コンテンツのインポート時には、管理画面からデータを登録する場合と同様に、各入力項目に設定されたルール等に基づいて内容のチェックが行われます（バリデーション）。
インポート対象のコンテンツに1件でもエラーがある場合、その時点で処理は中断され、コンテンツは追加されません。
各フィールドのバリデーションに加えて、CSVファイル内のデータに下記のような問題がある場合も、同様にエラーとなります。
サービスにコンテンツを一括登録する方法として、CSVインポートの他にWRITE系APIによる登録もございます。
それぞれの特長や使い分けについては、以下のブログ記事にて詳しくご紹介していますので、ぜひご参照ください。
