microCMS
ドキュメント
  • 料金プラン
  • ブログ
  • よくある質問
  • お問い合わせ
  • ログイン
  • 無料ではじめる
ナビゲーション
チュートリアル
Next.js
  • Next.jsとの連携
  • Getting Started(App Router)
  • チュートリアル(App Router)
  • Getting Started(Pages Router)
  • チュートリアル(Pages Router)
Astro
  • Astroとの連携
  • Getting Started
  • チュートリアル
Nuxt
  • Nuxtとの連携
  • Getting Started
  • チュートリアル
Gatsby
  • Gatsbyとの連携
  • Getting Started
  • チュートリアル
JavaScript
  • JavaScriptとの連携
  • Getting Started(ブラウザ)
  • Getting Started(サーバー)
PHP
  • PHPとの連携
  • Getting Started
Ruby
  • Rubyとの連携
  • Getting Started
Go
  • Goとの連携
  • Getting Started
操作マニュアル
  • はじめに
アカウントとログイン
  • アカウント登録
  • ログイン
  • メールアドレス認証をする
サービス
  • サービスの作成
  • サービス設定
  • テンプレート
  • サービスの削除
お支払い
  • 料金プランの変更
  • 決済方法の登録と変更
API
  • APIの作成・管理
  • API設定
  • APIスキーマのエクスポート/インポート
フィールド
  • テキストフィールド
  • テキストエリア
  • 画像
  • 複数画像
  • 日時
  • 真偽値
  • セレクトフィールド
  • コンテンツ参照
  • 複数コンテンツ参照
  • 数字
  • ファイル
  • カスタム
  • 繰り返し
  • 拡張フィールド
コンテンツ
  • コンテンツの作成
  • コンテンツの編集
  • コンテンツ管理
  • ビュー
  • コンテンツのステータス
  • カスタムステータス
  • コンテンツIDの設定
  • コンテンツに自動付与される値
  • コンテンツのCSVエクスポート
  • コンテンツのCSVインポート
  • APIプレビュー
  • APIプレビューを活用したクエリパラメータの利用例
  • レンダリング方式ごとの組み込み方法
  • 画面プレビュー
  • コンテンツのWebhookを設定
リッチエディタ
  • リッチエディタの操作方法
  • リッチエディタのWRITE API
  • 旧リッチエディタの操作方法
レビュー機能
  • レビュー
  • AIレビュー
メディア
  • メディア管理
  • メディアのフィルター・表示順の変更
  • メディアのタグ設定
  • メディアのWebhookを設定
  • メディアのカスタムドメイン設定
権限管理
  • メンバーの管理
  • ロール(管理画面の権限管理)
複数環境
  • 複数環境(開発環境)
  • 環境間のAPI設定のマージ
外部連携
  • Amazon S3連携
データログ
  • 監査ログ
  • データ転送量
セキュリティ
  • コンテンツの更新履歴
  • 管理画面のIP制限
  • APIのIP制限
認証設定
  • 2要素認証の設定
  • 2要素認証の必須化
  • シングルサインオン
仕様・制限事項
  • 推奨環境
  • 制限事項/注意事項
コンテンツAPI
  • コンテンツAPIとは
基本操作
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
APIキー
  • APIキー(APIの認証と権限管理)
  • 旧API(X-API-KEYなど)からの移行
レスポンスとエラー処理
  • GET APIのフィールドごとのレスポンス形式
  • GET APIにおけるクエリパラメータの指定
  • コンテンツAPIのエラーレスポンス
マネジメントAPI(ベータ)
  • マネジメントAPIとは
コンテンツ操作
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
メディア操作
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
メンバー操作
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API操作
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
  • POST /api/v1/apis
サービス操作
  • GET /api/v1/service
レスポンスとエラー処理
  • マネジメントAPIのエラーレスポンス
画像API
  • 画像APIとは
主なパラメータ
  • 画像サイズ
  • 品質
  • 解像度・画面サイズ
  • フォーマット
  • テキスト
  • 枠線
  • パディング
  • 形状
  • ダウンロード
  • ウォーターマーク
MCPサーバー
  • microCMS MCP
  • microCMS Document MCP Server
  • トップ
  • 操作マニュアル

繰り返し

最終更新日: 2026/05/14

繰り返しフィールドはカスタムフィールドを複数選択し、好きな順序で入力を繰り返すことのできるフィールドです。
入力したデータは配列として返却されるので、フロントエンド側で自由度の高いデザインをすることが可能です。

繰り返しフィールドを利用するためには、事前にカスタムフィールドを作成しておく必要があります。

カスタムフィールドの作成についてはこちらをご覧ください。

カスタム
https://document.microcms.io/manual/custom-field

フィールドの設定方法

以下のようなカスタムフィールドが作成されている前提で、設定方法をご説明します。

  • heading(見出し):テキストフィールド
  • link(リンク):テキストフィールド
  • text(テキスト):リッチエディタ
  • image(画像):画像
  • imageText(画像 + テキスト):画像 + リッチエディタ
  • relatedLinks(関連記事リンク):複数コンテンツ参照

次にこれらのカスタムフィールドを使って繰り返しフィールドを設定するために、「API設定」→「APIスキーマ」に移動し、フィールドの「種類」として「繰り返し」を選択します。



モーダルウィンドウが開き、事前に設定したカスタムフィールドの中でどのカスタムフィールドを利用するか選択できます。利用したいものにチェックを入れ、「決定」をクリックします。


データの入稿方法

次に編集画面での入稿方法をご説明します。

フィールドの追加

繰り返しフィールドが設定されていると、次のようなフィールド(繰り返しフィールド(デモ))が用意されています。



「+フィールドを追加」ボタンをクリックすると、どのカスタムフィールドを使用するか選択するためのポップアップが表示されます。



ここで「見出し」を選ぶと、見出しとして設定したカスタムフィールド(テキストフィールド)が表示されます。



また、「フィールドを追加」ボタンを押すと、下にフィールドを追加していくことができます。



三点リーダーをクリックすると表示されるメニューからは、上下にフィールドを追加できます。



今度は「画像+テキスト」のフィールドを追加します。
すると、以下のように「1. 見出し」「2. 画像+テキスト」のフィールドを並べることができます。


Tips

「画像+テキスト」のフィールドは入力フォームが横並びになっていますが、このようなフィールドのレイアウト設定はカスタムフィールド側で行います。設定方法については以下のドキュメントをご覧ください。

カスタム
https://document.microcms.io/manual/custom-field

フィールドの移動

「=」をドラッグ&ドロップすると、フィールドを上下に移動できます。



三点リーダーをクリックすると表示されるメニューからも、フィールドを上下に移動できます。


フィールドの折りたたみ

カスタムフィールド名の横にある矢印をクリックすると、フィールドの折りたたみ・展開ができます。


フィールドの削除

フィールドを削除するには、三点リーダーをクリックしてメニューを表示し「フィールドを削除」をクリックします。



API、CSVを利用した入稿については以下のドキュメントをご参照ください。

POST /api/v1/{endpoint}
https://document.microcms.io/content-api/post-content#had86c3779e
コンテンツのCSVインポート
https://document.microcms.io/manual/csv-import#h2b3036ae9c

制限事項/注意事項

  • 繰り返しフィールドで設定できるカスタムフィールド数に上限は設けていません。
  • 繰り返しフィールドで使用しているカスタムフィールドを削除すると、既にそのフィールドを使って登録していたデータは管理画面には表示され続けますが、APIレスポンスからは除外されます。

フィールドの詳細設定

設定項目

説明

必須項目

設定をONにすると入稿時の入力が必須となります。

説明文

入稿画面に表示する説明文です。

繰り返しフィールド

繰り返しフィールドに使用するカスタムフィールドを設定します。

並び順

カスタムフィールドを選択する際の並び順を設定します。

繰り返しフィールドの数を制限する

繰り返しフィールドの最小数と最大数を設定します。

APIのレスポンス

それでは実際に値を入力して、APIからデータを取得してみましょう。確認のため、次のように入力します。



APIプレビューで実際にプレビューしてみると、次のようなレスポンスが得られます。

{
    "id": "kkk7km7-ng",
    "createdAt": "2023-08-28T06:25:36.825Z",
    "updatedAt": "2023-08-28T06:25:36.825Z",
    "repeat": [
        {
            "fieldId": "heading",
            "heading": "見出しです"
        },
        {
            "fieldId": "imageText",
            "image": {
                "url": "https://images.microcms-assets.io/assets/xxxxxx/xxxxxx/blog-template.png",
                "height": 630,
                "width": 1200
            },
            "text": "<h1 id=\"h4a6e27f824\">繰り返しフィールドとは</h1><p>カスタムフィールドを複数選択し、好きな順序で入力を繰り返すことができるフィールドです。</p>"
        }
    ]
}


GET APIの基本的なレスポンス形式については以下のドキュメントをご参照ください。

GET APIのフィールドごとのレスポンス形式
https://document.microcms.io/content-api/get-api-field-responses#hc127980c8b

フロントエンドでの利用方法

配列の要素ごとにコンポーネントを定義(<Heading />, <ImageText />)しておき、API経由で得た値を渡す例をご紹介します。以下、Reactにおける実装例です。

export const Main = ({ repeat }) => (
  <main>
    {repeat.map((item, i) =>
      item.fieldId === 'heading' ? (
           // 見出し表示用のコンポーネントを利用する
        <Heading key={i} text={item.text} />
      ) : item.fieldId === 'imageText' ? (
           // 画像 + テキスト表示用のコンポーネントを利用する
        <ImageText key={i} image={item.image} text={item.text} />
      ) : null
    )}
  </main>
);


ここでは、繰り返しフィールドの配列(repeat)をmap()メソッドで変換し、fieldIdごとに適したコンポーネントを出力しています。
このようにすることで、編集画面で入力した順序のまま、ビューを構築することができます。

その他の活用事例

繰り返しフィールドを用いると、表現に合わせた柔軟なフィールドが構築できます。
繰り返しフィールドの活用事例、実装事例として以下のブログなどもご用意していますので、こちらも併せてご参照ください。

繰り返しフィールド・カスタムフィールドをマスターしよう | microCMSブログ
https://blog.microcms.io/intro-custom-repeatfield/
microCMSの繰り返しフィールドを利用して対談風のデザインを作る | microCMSブログ
https://blog.microcms.io/conversation-design/
microCMSのカスタムフィールドを使ってランディングページを作ろう | microCMSブログ
https://blog.microcms.io/custom-field-lp/
カスタムフィールドを使用してブログにCVエリアを追加しよう | microCMSブログ
https://blog.microcms.io/nuxt-cv-point/

目次

  • フィールドの設定方法
  • データの入稿方法
  • フィールドの追加
  • フィールドの移動
  • フィールドの折りたたみ
  • フィールドの削除
  • 制限事項/注意事項
  • フィールドの詳細設定
  • APIのレスポンス
  • フロントエンドでの利用方法
  • その他の活用事例
  • 運営会社
  • 特定商取引法に基づく表記
  • 利用規約
  • プライバシーポリシー

Copyright © microcms.io All rights reserved.