microCMSの記事が反映されない原因|Webhookと再ビルドを実測
VIEW →
WebサイトのCMSを調べていると、「ヘッドレスCMS」という言葉を目にする機会が増えました。従来型CMSとの違いが分からないまま、「表示が速い」「セキュリティに強い」といった特徴だけで比較すると、導入後に必要な開発や運用を見落とします。
ヘッドレスCMSとは、記事や画像などのコンテンツを管理する機能と、Webサイトの画面を表示する機能を分離し、APIで連携するCMSです。管理画面で入稿しただけではWebページは完成せず、コンテンツを取得して表示するフロントエンドを別に用意します。
この記事では、2026年8月30日時点のAWS、Google、WordPress、microCMSなどの公式資料をもとに、ヘッドレスCMSの仕組み、メリット・デメリット、向いているサイト、導入手順を整理します。特定サービスの機能比較ではなく、ヘッドレスCMSを採用するか判断するための調査結果です。
ヘッドレスCMSの要点は、次の3つです。
「ヘッド」はWebサイトやアプリなどの表示部分を指します。「ヘッドレス」は画面が存在しないという意味ではなく、CMSに特定の表示画面が組み込まれていない状態です。AWSの解説でも、コンテンツの管理・保存と表示を分離し、APIを通して独立したフロントエンドへ配信する構成と説明されています。
この分離によって、同じコンテンツをWebサイト、アプリ、デジタルサイネージなどで利用できます。一方、APIから取得したデータを画面として組み立てる開発が必要です。自由度と引き換えに、従来型CMSが一体で提供していた機能を個別に設計するのがヘッドレスCMSです。
ヘッドレスCMSを使ったWebサイトは、主に次の3つで構成されます。
構成要素 | 役割 |
|---|---|
CMS | 記事、画像、著者、カテゴリなどのコンテンツを管理する |
API | CMSに保存したコンテンツをフロントエンドへ渡す |
フロントエンド | APIから取得したデータをHTMLや画面として表示する |
基本的な流れは、次のとおりです。
編集者がCMSへ入稿
↓
CMSがコンテンツを保存
↓ API
Webサイト・アプリがコンテンツを取得
↓
利用者の画面へ表示
CMSには、ページ全体を一つの入力欄で管理する方法だけでなく、タイトル、本文、画像、著者、公開日などを項目に分けて管理する方法があります。このような構造化されたコンテンツは、表示先に合わせて必要な項目を再利用しやすい点が特徴です。
ただし、コンテンツを構造化すれば自動的に使いやすくなるわけではありません。記事、商品、店舗などの「コンテンツの種類」と、それぞれに必要な項目や関係を先に設計します。Contentfulの用語集でも、コンテンツモデリングはコンテンツタイプとワークフローを設計する工程とされています。
従来型CMSは、コンテンツ管理と画面表示を一つのシステムにまとめます。管理画面で記事を書き、テーマやテンプレートを使って公開するため、少ない構成でWebサイトを立ち上げやすい方式です。
ヘッドレスCMSは表示部分を持たず、APIで任意のフロントエンドと接続します。デカップルドCMSは両者の中間にあたり、標準の表示機能を持ちながら、API経由でもコンテンツを利用できる構成です。
比較項目 | 従来型CMS | デカップルドCMS | ヘッドレスCMS |
|---|---|---|---|
コンテンツ管理 | CMS内 | CMS内 | CMS内 |
標準の表示機能 | あり | あり | なし |
API連携 | 製品・構成による | あり | 中心となる機能 |
フロントエンド | CMSのテーマやテンプレート | 標準画面と外部画面を併用 | 別途開発する |
導入のしやすさ | 比較的始めやすい | 構成による | 開発体制が必要 |
表示先の自由度 | テーマの仕様に影響される | 比較的高い | 高い |
製品名だけで方式が決まるとは限りません。WordPressはテーマを使う従来型CMSとして広く利用されていますが、WordPress REST APIを使い、コンテンツを別のWebサイトやアプリへ渡すこともできます。つまり、WordPressをコンテンツ管理側として使うヘッドレス構成も可能です。
ヘッドレスCMSから取得したコンテンツをWebページとして表示する方法には、CSR、SSR、SSG、ISRなどがあります。どの方式を選ぶかによって、更新の反映速度、サーバー負荷、ビルド時間、検索エンジンへの伝わり方が変わります。
方式 | HTMLを作るタイミング | 主な特徴 | 確認したい点 |
|---|---|---|---|
CSR | ブラウザでページを開いた後 | 操作に応じてデータを更新しやすい | 初期表示、JavaScript、APIキー、SEO |
SSR | ページへのアクセス時 | 最新データを反映しやすい | サーバー負荷、キャッシュ、障害時の挙動 |
SSG | ビルド時 | 生成済みHTMLをCDNから配信しやすい | 更新時のビルド、反映時間、ページ数 |
ISR | 初回または再生成の条件を満たした時 | 静的配信と更新性を両立しやすい | 対応するフレームワークとインフラ、キャッシュ |
microCMSの公式ドキュメントでは、CSR、SSR、SSG、ISRごとの仕組みと向いているケースが整理されています。サイト全体を一つの方式に統一せず、ページの更新頻度や性質に応じて使い分けることもできます。
たとえばSSGでは、CMSで記事を公開した後にWebhookでビルドを開始し、生成したファイルをデプロイして公開サイトへ反映する流れがあります。microCMSのWebhookも、コンテンツの公開・更新をきっかけにCloudflare PagesやVercelなどのビルドを開始できます。CMSの公開操作とWebサイトへの反映が同時とは限らないため、更新方法まで含めて設計します。
コンテンツと画面が分かれているため、一つのCMSに保存した情報をWebサイト、アプリ、店頭端末などへAPIで渡せます。表示先ごとに同じ情報を入力し直す必要がなく、更新元を集約できます。
ただし、自動的にすべての表示先へ反映されるわけではありません。それぞれのフロントエンドにAPI連携と表示処理を実装し、キャッシュやビルドを更新する仕組みが必要です。
CMSのテーマに画面を合わせる必要がないため、要件に応じた言語やフレームワークでフロントエンドを構築できます。Webサイトとアプリで異なるUIを作りながら、コンテンツは共通で管理できます。
この自由度は、独自のデザインやインタラクションを実装したい場合に有効です。一方、フロントエンドの開発・テスト・更新も自分たちの管理範囲になります。
コンテンツのデータ構造を維持したまま、フロントエンドのデザインや技術構成を変更できます。反対に、画面の実装を大きく変えず、CMS内のコンテンツを更新することもできます。
この分離を活かすには、本文中へ見た目を決めるHTMLを過度に埋め込まず、タイトル、画像、説明、関連情報などを再利用できる単位で設計します。
SSGで生成したHTMLをCDNから配信する、SSRの結果をキャッシュする、画像とJavaScriptを最適化するといった構成を選べます。CMSへアクセスする処理を閲覧のたびに行わない設計では、サーバー処理と通信の待ち時間を減らせます。
ただし、ヘッドレスCMSを利用するだけでWebサイトが速くなるわけではありません。大きな画像、過剰なJavaScript、適切でないキャッシュ、遅いAPI呼び出しがあれば表示は遅くなります。速度はCMS名ではなく、レンダリング方式、配信環境、フロントエンドの実装を含めて確認します。
Googleは、Core Web Vitalsをランキングシステムで使用する一方、良好な数値だけで検索上位が保証されるわけではないと説明しています。表示速度は検索順位のためだけでなく、利用者が読みやすく操作しやすいWebサイトを作るために改善します。参考:Google検索におけるページエクスペリエンス
microCMSのようなSaaS型ヘッドレスCMSでは、CMS本体のインフラやアップデートをサービス提供者が管理します。microCMSの公式ヘルプでも、CMS用のインフラはmicroCMS側が管理し、利用者はWebサイトのフロントエンドを配信するWebサーバーを用意すると説明されています。利用者はCMSを動かすサーバーを自分で管理せず、フロントエンドの実装と配信へ管理範囲を絞れます。
一方、Webサイトを表示するフロントエンド、ホスティング、ビルド、Webhook、監視は別に必要です。オープンソースのヘッドレスCMSを自社でホストする場合は、CMS側のインフラとアップデートも管理します。「ヘッドレスCMSは保守不要」ではなく、採用する製品と構成によって保守範囲が変わります。
ヘッドレスCMSには、公開用Webサイトの完成した画面がありません。APIからデータを取得し、HTML、CSS、JavaScriptなどで表示するフロントエンドを構築します。ホスティング、ドメイン、ビルド、デプロイの設計も必要です。
CMSの月額料金だけで費用を比較すると、導入工数を見落とします。初期費用には、要件整理、コンテンツモデル、フロントエンド、データ移行、プレビュー、公開フローなどを含めます。
従来型CMSでは、編集画面とWebサイトのテンプレートが同じシステムにあるため、公開前の表示を確認しやすい製品があります。ヘッドレスCMSでは表示側が独立しており、下書きデータを取得してフロントエンドで描画する仕組みが必要です。
microCMSの画面プレビューでも、コンテンツIDとdraftKeyをフロントエンドへ渡し、下書き状態のコンテンツを取得・表示する実装が必要とされています。編集者がどの端末・ページ・言語を確認するかまで決めておくと、公開後の修正を減らせます。
ヘッドレスCMSが記事データを返しても、検索結果で使われるHTMLが自動的に完成するわけではありません。ページごとのtitle、meta description、canonical、OGP、構造化データ、サイトマップ、robots.txt、HTTPステータスなどをフロントエンド側で実装します。
CSRでもGoogleはJavaScriptを実行してページを処理しますが、GoogleのJavaScript SEOガイドは、利用者とクローラーの速度や、JavaScriptを実行しないボットを考慮し、サーバー側のレンダリングや事前レンダリングを有効な方法として案内しています。検索流入が重要な記事やサービスページは、取得時のHTMLに主要な内容とリンクが含まれる構成を基本にします。
microCMSとNext.jsで実装する項目は、「microCMSのSEO対策チェックリスト」で詳しく解説しています。
ヘッドレスCMSが主に扱うのはコンテンツです。お問い合わせフォーム、サイト内検索、会員認証、予約、決済、コメントなどは、フロントエンドや外部サービス、別のバックエンドで実装します。
従来型CMSのプラグインで対応していた機能がある場合は、移行前に一覧化します。CMSの置き換えだけを検討すると、公開直前に不足機能が見つかります。
CMS、API、フロントエンド、ホスティングが分かれるため、不具合が発生した場所を切り分ける必要があります。記事が反映されない場合でも、CMSの公開状態、APIレスポンス、Webhook、ビルド、デプロイ、キャッシュのどこに原因があるかを確認します。
監視対象、エラー通知、再実行の方法、障害時の公開手順を事前に決めます。サービスを選ぶときは、稼働状況、バックアップ、データのエクスポート、API制限、サポートも確認します。
APIのフィールド名やデータ型を変更すると、その値を利用するWebサイトやアプリへ影響します。複数の表示先で使うほど、変更前の影響調査が重要です。
フィールドを削除・変更する前に利用箇所を確認し、必要に応じて新旧のフィールドを併存させて段階的に移行します。コンテンツモデルもAPIの仕様として管理します。
CMSの管理画面と公開サイトを分離すると、公開サーバーでCMS本体を直接動かさない構成を選べます。SSGでは、生成済みの静的ファイルを配信し、閲覧時にCMSへ接続しない設計も可能です。CMS本体を公開側へ置く構成と比べ、攻撃対象を分けやすい点はメリットです。
ただし、APIを使う以上、認証と権限管理は必要です。OWASP API Security Top 10には、オブジェクト単位の認可不備、認証不備、設定ミス、APIの不適切な管理などが挙げられています。
書き込み権限や非公開データの取得権限を持つAPIキーは、フロントエンドのソースコードへ直接書かず、用途ごとに分けて必要最小限の権限を設定します。ブラウザからCMSへ直接アクセスする構成ではキーが利用者から見えるため、公開データの読み取りに必要な権限だけを付けるか、サーバー側を経由します。microCMSのAPIキードキュメントでも、CSRでは外部の利用者がAPIキーを把握できるため、必要最低限のGET権限に絞る方法と、サーバー側からAPIへ接続してキーを秘匿する方法が案内されています。管理画面の多要素認証、権限分離、依存パッケージの更新、ログと監視も必要です。
ヘッドレスCMSはセキュリティ対策を不要にする仕組みではありません。CMSと公開サイトを分離したうえで、それぞれの入口と権限を管理する構成です。
導入判断では、サイトの規模よりも、表示先、デザイン、更新体制、開発体制を確認します。
向いているケース | 理由 |
|---|---|
Webサイトとアプリで同じ情報を使う | コンテンツをAPIで共通利用できる |
独自デザインや機能を実装する | CMSのテーマに縛られずフロントエンドを設計できる |
複数サイトの情報を一元管理する | 共通データの更新元を集約できる |
フロントエンドを段階的に更新したい | コンテンツと画面を分けて変更できる |
開発・運用を担当できる体制がある | API、公開、監視を継続して管理できる |
次のような場合は、従来型CMSやWebサイト作成サービスも比較します。
慎重に検討したいケース | 理由 |
|---|---|
一つの小規模サイトだけを早く公開したい | テーマやテンプレートを使う方が構築範囲を抑えやすい |
開発担当者がいない | フロントエンドと公開環境の保守が難しい |
編集者がページレイアウトを自由に変更したい | プレビューと編集UIの要件が大きくなる |
必要な機能が既存CMSのテーマやプラグインで揃う | 分離による追加開発が費用に見合わない |
ヘッドレスCMSは新しいから選ぶものではありません。コンテンツを複数の表示先で使う必要がなく、既存CMSで運用上の問題もない場合は、構成を増やさない判断も合理的です。
最初に、現在のCMSで困っていることと、ヘッドレスCMSで解決したいことを言語化します。Webサイト以外にアプリやサイネージへ配信するのか、デザインの自由度を高めたいのか、CMS基盤の保守を減らしたいのかを整理します。
目的が曖昧なまま製品を選ぶと、APIの機能や料金だけを比べることになります。
記事、固定ページ、商品、店舗、著者、カテゴリなど、管理する情報を一覧にします。タイトル、本文、画像、公開日、関連情報といった項目に分け、どの表示先で利用するかを確認します。
既存サイトから移行する場合は、URL、リダイレクト、画像、更新日時、SEO情報も対象です。
コンテンツの種類、フィールド、入力規則、参照関係を決めます。編集者、確認者、公開者の役割、承認、予約公開、プレビュー、多言語対応もこの段階で整理します。
APIとして扱いやすいことだけでなく、編集者が迷わず入力できる構成にします。
必要な条件に基づき、候補を比較します。
無料プランで試せる場合も、本番で必要なメンバー数、API数、通信量、権限機能を基準に費用を確認します。
更新頻度、アクセス数、SEO、個人別表示、公開までの時間をもとに、SSG、SSR、CSR、ISRを選びます。ホスティング、CDN、キャッシュ、画像配信、ビルド時間も同時に設計します。
記事ページはSSG、会員画面はCSRというように、ページごとに方式を分ける選択もあります。
CMSで公開した後に、どの処理を経てWebサイトへ反映するかを決めます。Webhook、ビルド、デプロイ、キャッシュ削除、プレビューURL、エラー通知、再実行の方法を一つの公開フローとして確認します。
フォーム、検索、認証などCMS外の機能と、SEO、アクセス解析、セキュリティもこの段階で実装します。
本番移行の前に、代表的なコンテンツとページで試作します。編集、確認、公開、更新、削除、復旧まで一通り実施し、担当者が無理なく運用できるか確認します。
既存サイトから移行する場合は、URLを維持するか301リダイレクトを設定し、公開前後でHTML、リンク、構造化データ、サイトマップ、Search Consoleを確認します。
当サイトでは、WordPressからmicroCMSへ移行し、microCMS、Next.js、Cloudflare Pagesを組み合わせたSSG構成で運用しています。microCMSでコンテンツを公開すると、Webhookをきっかけにビルドとデプロイを行い、生成したページを公開サイトへ反映します。
この構成では、CMSの管理画面と公開サイトが分かれています。コンテンツ管理はmicroCMS、HTMLの生成とSEO設定はNext.js、生成したファイルの配信はCloudflare Pagesが担当します。実際に運用すると、CMS選びだけでなく、プレビューと公開反映の経路まで設計する重要性が分かります。
移行後の構成とWordPressとの違いは「microCMSとWordPress徹底比較」、Webhookから公開反映までの確認結果は「microCMSの記事が反映されない原因」にまとめています。
ヘッドレスCMSだからSEOに弱いわけではありません。検索エンジンが取得できるHTML、title、canonical、構造化データ、サイトマップ、HTTPステータスなどをフロントエンド側で正しく実装すれば対応できます。CMSだけではSEO設定が完成しない点に注意が必要です。
必ず速くなるわけではありません。SSGとCDN、SSRのキャッシュなどを適切に使えば、表示速度を改善しやすい構成を作れます。画像、JavaScript、フォント、API、キャッシュの実装によっては遅くなります。
使えます。WordPress REST APIから投稿、固定ページ、カテゴリなどをJSONで取得し、別のフロントエンドで表示できます。WordPressの管理画面やプラグインを活かせる一方、WordPress側とフロントエンド側の両方を保守します。
記事の入稿や公開は、編集者向けの管理画面から行えるサービスがあります。ただし、最初のフロントエンド構築と、公開後の更新・監視には開発者が必要です。外部の制作会社へ保守を依頼する場合も、担当範囲を決めておきます。
サイトの規模だけでは決まりません。小規模でも、独自デザイン、複数チャネルへの配信、フロントエンド技術の要件があれば選択肢になります。一つのサイトを短期間で作り、標準機能だけで運用する場合は、従来型CMSやWebサイト作成サービスの方が構成を抑えられます。
CMSの利用料に加え、要件整理、コンテンツモデル、フロントエンド、ホスティング、ビルド、プレビュー、データ移行、フォームや検索、監視、保守の費用を確認します。CMSが無料でも、Webサイト全体の構築と運用が無料になるわけではありません。
ヘッドレスCMSは、コンテンツ管理と画面表示を分離し、APIで連携するCMSです。同じコンテンツを複数の表示先で利用でき、フロントエンドの技術やデザインを選びやすい一方、表示画面、公開フロー、プレビュー、SEO、フォーム、監視を別に設計します。
導入時は「ヘッドレスCMSなら速い・安全」と判断せず、更新頻度、表示先、編集体制、必要な機能、開発・保守の担当者を整理します。そのうえで、従来型CMS、デカップルドCMS、ヘッドレスCMSを同じ要件で比較することが重要です。
ヘッドレスCMSの価値は、CMS単体の機能ではなく、コンテンツをどのように構造化し、どの画面へ、どの公開方法で届けるかまで設計できる点にあります。小さな範囲で編集から公開まで試し、運用できることを確認してから採用範囲を広げると、導入後の手戻りを減らせます。

関連記事
この記事と同じテーマのコラムを紹介します。
講座・書籍の紹介
Web制作やマーケティングに役立った講座・書籍を紹介します。