# ヘッドレスCMSとは

コンテンツの管理機能を提供してAPIで配信し、表示は別に開発した画面が担当するCMSです。表示側を独立して開発する必要がある場合に適する一方、表示側の開発と保守が継続して必要になります。

## ヘッドレスCMSとは

ヘッドレスCMSはコンテンツの登録と管理を担当し、表示は別に開発した画面が担当するCMS（Content Management System）です。
登録した記事や商品の説明はAPIを通じて配信され、Webサイトやアプリがそれぞれの画面に表示します[^contentful]。

用途の例は、商品名、説明文、画像を管理画面で1回更新し、自社のWebサイト、スマートフォンのアプリ、店頭の案内画面の3つに配信する使い方です。
表示の部分はWebサイトとアプリのそれぞれで別に開発します。

従来型のCMSはコンテンツの管理とページの表示を1つの製品で担当します。
代表例はWordPressで、編集した内容はWordPressが生成するページにそのまま表示されます。
ヘッドレスCMSとの違いは、表示の部分を製品の内部で生成するか、製品の外部で開発するかです。
WordPressもAPIでコンテンツを外部に提供できるため、ヘッドレスCMSとしての利用も可能です[^wp-rest]。

![従来型のCMSは管理とページの生成を1つの製品で担当し、ヘッドレスCMSは管理だけを担当して、別に開発したWebサイト、アプリ、案内画面にAPIで配信することを示す図](https://media.marketing.kdotdev-tunnel.org/glossary-headless-cms-91d0b8d9bc4ea80f47d3beea1c64a00e73ab4461aede99564e665e06c45b85ac.png)

## ヘッドレスCMSが必要な理由

WordPressではページの見た目と構造がテーマやテンプレートの仕組みに依存します[^wp-theme]。
画面の表示速度やデザインを最適化するには、その仕組みを前提にした実装が必要になります。

配信先ごとに記事や商品の説明を別々に管理すると、同じ内容の更新が配信先の数だけ必要になります。

ヘッドレスCMSは管理と表示を分離し、表示側を任意の技術で開発できるようにします。
コンテンツを共通の項目として管理すれば、各配信先は必要な項目を取得して表示できます[^contentful]。
レイアウトを含むページをそのまま別の配信先で再利用する仕組みではないため、共通の項目として登録する設計が前提になります。

![配信先ごとの管理と共通の管理を比較する図。別々に管理すると同じ更新が配信先の数だけ必要になる。共通の項目として管理しAPIで配信すれば、1回の登録で各配信先に表示できる](https://media.marketing.kdotdev-tunnel.org/glossary-headless-cms-5b7b19fbd59f21be6d89e8242b893e296599de30b2b018f2d8886707223701f8.png)

## 効果とコスト

### 効果

- 共通の項目として登録したコンテンツを、Webサイト、アプリ、社内の別システムなど複数の配信先に配信できる
- 表示の部分をCMSのテーマに依存せずに開発でき、デザインや画面の構成を自由に設計できる
- 表示の部分を再構築する際も、登録済みの記事や商品の説明とその管理画面を維持できる

### コストとリスク

- 表示側の開発が必須で、導入後もその保守と改修に開発者が必要になる。従来型のCMSのようにテーマを適用して公開する使い方はできない
- 公開前の見た目を確認するには、表示側で下書きを取得して表示する仕組みを用意し、CMSのプレビュー機能があればそこから呼び出す[^nextjs-draft]
- 編集の担当者が変更できるレイアウトの範囲は、表示側の設計で決定される
- 更新した記事や商品の説明を公開画面に反映する連携と、その失敗を検知する仕組みも保守の対象になる
- SaaSのヘッドレスCMSには、利用者数、コンテンツの件数、APIの呼び出し回数を課金の基準やプランの上限として設定する製品がある[^contentful-pricing]。表示側のサーバーと配信の費用も別に見積もる
- 製品を変更する際は登録済みの記事や商品の説明を移行できるか、表示側にどの範囲の改修が必要かを確認する

![ヘッドレスCMSの効果とコストを示す図。複数の配信先への配信、表示の自由な設計、表示の再構築の際の内容の維持という効果がある。一方で、表示側の開発と保守、プレビューの連携、公開画面への反映の連携、CMSと表示側の費用がかかる](https://media.marketing.kdotdev-tunnel.org/glossary-headless-cms-6629d7150b86e5a54940ca52f361a42f1213c84b9d5f08cfa60530a896b7e866.png)

## ヘッドレスCMSを採用すべきか

既存のCMSのAPIで必要な配信を実現できるなら、CMSの置換は当面不要です。
そのうえで次のどちらかに該当し、表示側の保守の体制を維持できるなら、ヘッドレスCMSを候補にします。

- 同じコンテンツを複数の配信先に配信する。Webサイトとアプリ、複数ブランドのサイト、社内の別システムへの提供など
- Webサイト自体を自社の製品やサービスの一部として継続的に開発し、表示の速度やデザインをCMSのテーマに依存せずに最適化する

体制の条件は表示側の改修と障害対応を導入後も継続して担当できることです。

配信先がWebサイト1つで、更新の担当者がページのレイアウトを自分で変更する場合は、従来型のCMSを第一候補にします。
表示側の保守の体制を維持できない場合も、表示崩れや画面を表示できない障害などを修正できなくなるため、従来型のCMSを採用します。

![ヘッドレスCMSの採用の判断の図。表示を独立して開発する必要がなければ従来型のCMSを採用する。既存のCMSのAPIで可能なら既存のAPIで配信する。表示を独立させる必要があり、既存のAPIで実現できず保守の体制も維持できるならヘッドレスCMSを候補にする。保守ができなければ従来型のCMSを採用する](https://media.marketing.kdotdev-tunnel.org/glossary-headless-cms-8faf4104059dcd3f472a03b1c290b872b084f8036b8de8e09938ab189105fb83.png)

## よくある誤解

### ヘッドレスCMSにすればサイトの表示が高速化する

表示の速度は表示の部分の実装と配信の仕組みに依存します。
キャッシュや画像の最適化など、表示側の実装が速度を左右します。
実装によっては従来型のCMSより低速になることもあります。

### ヘッドレスCMSならセキュリティの対策は不要になる

公開されるWebサイトとCMSの管理画面を分離する構成を選択できます。
それでも、管理画面のアカウント、APIの認証の鍵、下書きの公開範囲、表示側のシステムの脆弱性は管理する必要があります。

[^contentful]: [Headless CMS explained in 90 seconds](https://www.contentful.com/headless-cms/)（Contentful）
[^contentful-pricing]: [Pricing](https://www.contentful.com/pricing/)（Contentful）
[^wp-rest]: [REST API Handbook](https://developer.wordpress.org/rest-api/)（WordPress Developer Resources）
[^wp-theme]: [What Is a Theme?](https://developer.wordpress.org/themes/basics/what-is-a-theme/)（WordPress Developer Resources）
[^nextjs-draft]: [How to preview content with Draft Mode in Next.js](https://nextjs.org/docs/app/guides/draft-mode)（Vercel）
