microCMS
Documentation
  • Pricing
  • Blog
  • FAQ
  • Contact
  • Sign In
  • Get started for free
Navigation
Tutorial
Next.js
  • Integration with Next.js
  • Getting Started with App Router
  • Tutorial (App Router)
  • Getting Started with Pages Router
  • Tutorial (Pages Router)
Astro
  • Getting Started
  • Integration with Astro
  • Tutorial
Nuxt
  • Integration with Nuxt
  • Getting Started
  • Tutorial
Gatsby
  • Integration with Gatsby
  • Getting Started
  • Tutorial
JavaScript
  • Integration with JavaScript
  • Getting Started (Browser)
  • Getting Started (Server)
PHP
  • Integration with PHP
  • Getting Started
Ruby
  • Integration with Ruby
  • Getting Started
Go
  • Integration with Go
  • Getting Started with microCMS
Manual
  • Introduction
Account & Login
  • Account Registration
  • Login
  • Email Address Authentication
Services
  • Creating a Service
  • Service Configuration
  • Template
  • Service Deletion
Payment
  • Change of Pricing Plan
  • Registering and Changing Payment Methods
API
  • Creating and Managing APIs
  • API Settings
  • Export/Import of API Schema
Fields
  • Text Field
  • Text Area
  • Image
  • Multiple Images
  • Date
  • Boolean
  • Selectable Field
  • Content Reference
  • Multiple Content References
  • Number
  • File
  • Extended Field
  • Repetition
  • Custom
Contents
  • CSV Export of Content
  • Content Creation
  • Content Editing
  • Content Management
  • View
  • Content Status
  • Custom Status
  • Setting the Content ID
  • Automatically Assigned Values for Content
  • CSV Import of Content
  • API Preview
  • Examples of Using Query Parameters with API Preview
  • Integration Methods by Rendering Type
  • Screen Preview
  • Setting Up Webhooks for Content
Rich Editor
  • How to Use the Rich Editor
  • Rich Editor WRITE API
  • How to Use the Old Rich Editor
Reviews
  • Review
  • AI Review
Media
  • Media Management
  • Changing Media Filters and Display Order
  • Media Tag Configuration
  • Setting Up Media Webhooks
  • Custom Domain Settings for Media
Permission Management
  • Member Management
  • Roles (Permission Management in the Admin Panel)
Environments
  • Multiple Environments (Development Environment)
  • Merging API Settings Between Environments
Connection
  • Amazon S3 Integration
Logs
  • Audit Log
  • Data Transfer Volume
Security
  • Content Update History
  • IP Restrictions for Management Dashboard
  • IP Restrictions for APIs
Authentication
  • Setting Up Two-Factor Authentication
  • Mandatory Two-Factor Authentication
  • Single Sign-On
Specifications & Limitations
  • Recommended Environment
  • Limitations / Precautions
Content API
  • What is the Content API?
Basic Operations
  • 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 Keys
  • API Key (API Authentication and Authorization Management)
  • Migration from the Old API (X-API-KEY, etc.)
Responses & Error Handling
  • Response format for each field in the GET API
  • Specifying Query Parameters in the GET API
  • Error Responses of the Content API
Management API (Beta)
  • POST /api/v1/roles
  • DELETE /api/v1/roles/{role_id}
  • GET /api/v1/roles/{role_id}
  • PATCH /api/v1/roles/{role_id}
  • GET /api/v1/roles
  • What is the Management API?
Content Operations
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
  • 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
Media Operations
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
Member Operations
  • PATCH /api/v1/members/{member_id}
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API Operations
  • POST /api/v1/apis
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
Service Operations
  • GET /api/v1/service
Responses & Error Handling
  • Management API Error Responses
Image API
  • What is the Image API?
Parameters
  • Image Size
  • Quality
  • Resolution and Screen Size
  • Format
  • Text
  • Border
  • Padding
  • Shape
  • Download
  • Watermark
MCP Server
  • microCMS MCP
  • microCMS Document MCP Server
  • Top
  • Manual

Repetition

Last updated: 2026/05/14

The repeat field is a field that allows you to select multiple Custom Fields and input data in your preferred order repeatedly.
The entered data is returned as an array, enabling a high degree of design flexibility on the frontend.

To use the repeat field, you need to create Custom Fields in advance.

For information on creating Custom Fields, please see this page.

Custom
https://document.microcms.io/en/manual/custom-field

How to Set Up Fields

Assuming that the following Custom Fields have been created, I will explain how to set them up.

  • heading: Text Field
  • link: Text Field
  • text: Rich Editor
  • image: Image
  • imageText: Image + Rich Editor
  • relatedLinks: Multiple Content Reference

Next, to set up a repeating field using these Custom Fields, go to "API Settings" → "API Schema" and select "Repeating" as the "Type" of the field.



A modal window will open, allowing you to select which Custom Fields you want to use from the ones you have set up in advance. Check the ones you want to use and click "Decide."


How to Input Data

Next, I will explain how to input data in the editing screen.

Adding Fields

When a repeating field is set up, the following fields (Repeating Field (Demo)) will be available.



Clicking the "+ Add Field" button will display a popup to select which Custom Field to use.



If you select "Heading" here, the Custom Field set as a heading (Text Field) will be displayed.



Additionally, pressing the "Add Field" button allows you to add fields below.



From the menu that appears when you click the ellipsis, you can add fields above or below.



Now, I will add the "Image + Text" field.
Then, you can arrange the fields as "1. Heading" and "2. Image + Text" as shown below.


Tips

The "Image + Text" field has the input forms arranged side by side, but the layout settings for such fields are managed on the Custom Field side. Please refer to the document below for the configuration method.

Custom
https://document.microcms.io/en/manual/custom-field

Moving Fields

You can move fields up and down by dragging and dropping the "=".



You can also move fields up and down from the menu that appears when you click the three-dot icon.


Collapsing Fields

You can collapse or expand fields by clicking the arrow next to the Custom Field name.


Deleting Fields

To delete a field, click the three-dot icon to display the menu and select "Delete Field".



For information on submissions using the API and CSV, please refer to the following documentation.

POST /api/v1/{endpoint}
https://document.microcms.io/en/content-api/post-content#had86c3779e
CSV Import of Content
https://document.microcms.io/en/manual/csv-import#h2b3036ae9c

Limitations / Notes

  • There is no limit on the number of Custom Fields that can be set in a repeatable field.
  • If you delete a Custom Field used in a repeatable field, the data that has already been registered using that field will continue to be displayed in the management screen, but will be excluded from the API response.

Field Detailed Settings

Settings

Description

Required Field

When enabled, input will be mandatory during submission.

Description Text

This is the description text displayed on the submission screen.

Repeating Field

Set the custom fields to be used for the repeating field.

Order

Set the order in which custom fields are selected.

Limit the Number of Repeating Fields

Set the minimum and maximum number of repeating fields.

API Response

Now, let's input some values and retrieve data from the API. For confirmation, we will input as follows.



When you actually preview it in the API preview, you will receive a response like the following.

{
    "id": "kkk7km7-ng",
    "createdAt": "2023-08-28T06:25:36.825Z",
    "updatedAt": "2023-08-28T06:25:36.825Z",
    "repeat": [
        {
            "fieldId": "heading",
            "heading": "This is a heading"
        },
        {
            "fieldId": "imageText",
            "image": {
                "url": "https://images.microcms-assets.io/assets/xxxxxx/xxxxxx/blog-template.png",
                "height": 630,
                "width": 1200
            },
            "text": "<h1 id=\"h4a6e27f824\">What a Repeating Field Is</h1><p>This is a field that allows you to select multiple Custom Fields and repeat the input in any order you like.</p>"
        }
    ]
}


For the basic response format of the GET API, please refer to the following documentation.

Response format for each field in the GET API
https://document.microcms.io/en/content-api/get-api-field-responses#hc127980c8b

How to Use in Frontend

Define components for each element of the array (<Heading />, <ImageText />) and here is an example of passing values obtained via the API. Below is an implementation example in React.

export const Main = ({ repeat }) => (
  <main>
    {repeat.map((item, i) =>
      item.fieldId === 'heading' ? (
           // Use the component for displaying headings
        <Heading key={i} text={item.text} />
      ) : item.fieldId === 'imageText' ? (
           // Use the component for displaying image + text
        <ImageText key={i} image={item.image} text={item.text} />
      ) : null
    )}
  </main>
);


Here, the array of the repeat field (repeat) is transformed using the map() method, outputting the appropriate component for each fieldId. This allows you to build the view in the same order as entered in the editing screen.

Other Use Cases

Using repeat fields allows for the construction of flexible fields tailored to the expression.
We also have examples of use cases and implementations of repeat fields available in the following blogs, so please refer to those as well.

繰り返しフィールド・カスタムフィールドをマスターしよう | 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/

Contents

  • How to Set Up Fields
  • How to Input Data
  • Adding Fields
  • Moving Fields
  • Collapsing Fields
  • Deleting Fields
  • Limitations / Notes
  • Field Detailed Settings
  • API Response
  • How to Use in Frontend
  • Other Use Cases
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.