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

Multiple Content References

Last updated: 2026/09/03

The multiple content reference is a field that allows you to link multiple pieces of content managed by a different API.
It is used to associate multiple categories with an article or to select and link multiple related articles, facilitating information sharing and establishing relationships.

Data Submission Methods

  • The basic operation method is the same as the Content Reference Field.
  • In the case of multiple Content Reference Fields, you can select multiple contents at once.

Notes

  • The order of the selected contents can be rearranged using drag and drop.
  • The order of multiple Content References in the Administration console is also reflected in the API response, and the array will be returned in the order displayed in the Administration console.


Please refer to the following documents for submission using API and CSV.

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

Checking Referenced Content

A screenshot highlighting the 'Referenced n times' link displayed at the top of the content detail screen.


If a specific content is referenced by other contents, a button labeled [Referenced n times] will appear in the upper right corner of the content detail screen, allowing you to check the current number of references.
Clicking this button will display a list of the referencing contents in a modal window.

Limitations / Notes

  • If you do not have viewing permissions for the API that is the reference destination, you will not be able to select content or check the selection status.
  • If the selected content is in draft or has been unpublished, it will not be included in the API response. However, if your API key has permissions for "Retrieve all draft content" or "Retrieve all unpublished content," it can be obtained.
  • As a known issue, there may be cases where "Referenced 0 times" is associated with content that is not referenced. For more details, please refer to the help article "What should I do if 'Referenced 0 times' is associated with unreferenced content and I cannot delete it?".

Advanced Settings

Setting Item

Description

Required Field

When enabled, input is required during submission.

Description

This is the description displayed on the submission screen.

Referenced Content

Select the API to reference. This can only be selected when creating a new entry.

Items Displayed on the List Screen

You can select items to display on the contents list screen from Content ID or text field items. If the specified item does not exist, the Content ID will be displayed instead.

Limit the Number of Multiple Content References

Set the minimum and maximum number of selectable contents.

Default Value

You can set up to 5 content references as default values during submission.

Response Format of GET API

Please refer to the documentation below for details.

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

How to Use in Frontend

The multiple content reference field returns data in the form of an array of objects, so you can display the referenced information using a loop.
Below is an implementation example in Next.js that shows a list of related articles on the article detail page.

export default async function Page({ params }) {
  const { slug } = await params;

  // Fetch data using the microCMS JavaScript SDK (https://github.com/microcmsio/microcms-js-sdk)
  const data = await client.getListDetail({
    endpoint: "blog",
    contentId: slug,
  });

  return (
    <main>
      <h2>Related Articles</h2>
      <div>
        {/* relatedArticles is the field ID. Please replace it with the actual field ID */}
        {data.relatedArticles.map((article) => (
          <article key={article.id}>
            <Link href={`/blog/${article.id}`}>
              <Image
                src={article.eyecatch.url}
                alt={article.eyecatch.alt || ""}
                width={200}
                height={120}
              />
              <p>{article.title}</p>
            </Link>
          </article>
        ))}
      </div>
    </main>
  );
}

Contents

  • Data Submission Methods
  • Notes
  • Checking Referenced Content
  • Limitations / Notes
  • Advanced Settings
  • Response Format of GET API
  • How to Use in Frontend
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.