2026年9月19日

2026年9月19日

WordPressのビジュアルエディタが表示されないときの原因と直し方

WordPressのビジュアルエディタが表示されないときは、まずユーザープロフィールの「ビジュアルエディターを使用しない」設定を確認し、次にJavaScriptの読み込みエラー(プラグインの競合、キャッシュ、セキュリティ機能による遮断)を疑うのが近道です。この記事では、クラシックエディターとブロックエディターのそれぞれで起きる症状を見分け、原因を可能性の高い順に確認して直す方法を説明します。

設定ファイルやプラグインを触る前に、サイトのバックアップを取ってください。

どのエディターで起きているかを見分ける

「ビジュアルエディタ」が指すものは、使っている編集画面によって違います。

  • クラシックエディター(「Classic Editor」プラグインを使っている、または投稿タイプがブロックエディター非対応)では、本文欄の右上に「ビジュアル」と「テキスト」のタブがあります。症状は「ビジュアル」タブが無い、ツールバーが出ない、本文欄が素のテキスト欄になる、などです
  • ブロックエディターでは、通常は見たまま編集できる画面ですが、「コードエディター」に切り替わってHTMLだけが表示される、画面が真っ白になる、読み込み中のまま止まる、といった症状になります

ブロックエディターでHTMLだけが表示される場合は、まず右上のオプションメニュー(縦の三点アイコン)から表示モードがコードエディターになっていないかを確認します。キーボードショートカットで切り替わってしまうこともあります。これで戻れば設定の問題で、不具合ではありません。

原因1:プロフィールでビジュアルエディターが無効になっている

クラシックエディターで「ビジュアル」タブが無い場合、最も多い原因はユーザーごとの設定です。「ユーザー」→「プロフィール」に、ビジュアルエディターを使わないためのチェックボックスがあります。執筆時点では「ビジュアルエディター」の項目にあります(2026年10月現在)が、表記はバージョンにより異なります。チェックが入っているとそのユーザーだけ「テキスト」タブのみになります。

特定のユーザーだけで起きるならこの設定を疑ってください。WP-CLI ではユーザーメタの rich_editing で確認・変更できます。

# ユーザーID 2 の設定を確認("false" ならビジュアルエディターが無効)
wp user meta get 2 rich_editing

# 有効に戻す
wp user meta update 2 rich_editing true

原因2:プラグインやテーマのコードで無効化されている

全ユーザーで起きる場合は、コードで無効化されていないかを確認します。WordPressには、ビジュアルエディターを使えるかどうかを決める user_can_richedit フィルターがあり、これが false を返すとビジュアルエディターは表示されません。

テーマやプラグインのファイルをまとめて検索します。

grep -rn "user_can_richedit" wp-content/themes wp-content/plugins wp-content/mu-plugins
grep -rn "use_block_editor_for_post" wp-content/themes wp-content/plugins wp-content/mu-plugins

use_block_editor_for_post や use_block_editor_for_post_type は、ブロックエディターとクラシックエディターのどちらを使うかを切り替えるフィルターです。「ブロックエディターが出ずにクラシックエディターになった」場合は、これらのフィルターや「Classic Editor」プラグインの設定を確認します。カスタム投稿タイプでは、register_post_type の引数 show_in_rest が true でないとブロックエディターは使えません。

原因3:JavaScriptのエラーで読み込みが止まっている

エディターはJavaScriptで動いているため、どこかでエラーが起きると表示されなくなります。投稿編集画面を開いた状態でブラウザの開発者ツール(多くのブラウザでF12)を開き、「コンソール」タブに赤いエラーが出ていないかを見ます。

エラーの読み方の目安は次のとおりです。

  • エラーに wp-content/plugins/プラグイン名/ のパスが含まれていれば、そのプラグインが原因の候補
  • 404 や Failed to load resource は、スクリプトファイルが読み込めていない。キャッシュや最適化系プラグイン、CDN を疑う
  • 403 は、サーバーやセキュリティ機能がリクエストを遮断している可能性がある(原因5)

原因を絞り込むには、プラグインを一度に1つずつ無効化して確認します。本番サイトで全プラグインを止められない場合は、自分のログインセッションだけでプラグインを無効にできる「Health Check & Troubleshooting」プラグインのトラブルシューティングモードが使えます。管理画面に入れない場合は、FTPやファイルマネージャーで wp-content/plugins 内のフォルダ名を変えると、そのプラグインを無効にできます。

切り分け中は、wp-config.php に次の設定を一時的に加えると、管理画面のスクリプトが結合・圧縮されずに読み込まれ、エラーの箇所が分かりやすくなります。

define( 'SCRIPT_DEBUG', true );
define( 'CONCATENATE_SCRIPTS', false );

この設定で症状が消える場合は、スクリプトの結合や圧縮の過程に問題があることを示しています。確認が済んだら2行とも削除してください。

原因4:キャッシュや最適化の設定が管理画面に影響している

キャッシュ系や表示速度改善系のプラグイン、CDN の中には、JavaScriptの結合・遅延読み込み・圧縮を行うものがあります。本来は公開ページ向けの機能ですが、設定によっては管理画面のスクリプトにも影響し、エディターが動かなくなります。

  • 最適化プラグインの設定で、管理画面やログインユーザーを対象外にする
  • CDN を使っている場合は /wp-admin/ や /wp-includes/ をキャッシュ対象から外す
  • 設定を変えたら、プラグイン・サーバー・CDN・ブラウザのキャッシュを順に削除する

WordPressを更新した直後に起きた場合は、古いスクリプトがキャッシュに残り、新しい本体と食い違っていることがあります。ブラウザのキャッシュを消してから再読み込みしてください。

原因5:REST APIやリクエストが遮断されている

ブロックエディターは、保存や読み込みにREST API(/wp-json/ で始まるURL)を使います。セキュリティプラグインでREST APIを制限している、サーバーのWAF(不正アクセス防御の仕組み)が本文の内容を攻撃と誤判定している、といった場合、エディターが読み込めない、保存時にエラーになる、といった症状になります。

確認方法は次のとおりです。

  • 開発者ツールの「ネットワーク」タブで、wp-json を含むリクエストの応答コードを見る。401、403 が出ていれば遮断されている可能性が高い
  • 「ツール」→「サイトヘルス」で、REST API に関する警告が出ていないか確認する
  • レンタルサーバーのWAF機能を一時的に止めて症状が変わるか確認し、変わる場合はサーバーの管理画面で除外設定を行う

WAFを止めたままにするのは避け、原因の切り分けが済んだら有効に戻してください。

原因6:ブラウザ側の問題

広告ブロックやスクリプト制御の拡張機能が、エディターのスクリプトを止めていることがあります。プライベートウィンドウ(拡張機能が無効の状態)や別のブラウザで開いて症状が消えるなら、拡張機能を1つずつ無効にして原因を探します。古いブラウザでは新しいエディターが動かないこともあるので、ブラウザを最新版に更新してください。

まとめ

  • まず、クラシックエディターとブロックエディターのどちらの症状かを見分ける。ブロックエディターではコードエディター表示になっていないかを確認する
  • 特定ユーザーだけならプロフィールの設定(rich_editing)、全員ならフィルターやプラグインを疑う
  • 開発者ツールのコンソールとネットワークで、JavaScriptエラーや遮断されたリクエストを確認する
  • 最適化プラグインやCDNは管理画面を対象外にし、キャッシュを削除する
  • WAFやセキュリティ機能は除外設定で対応し、止めたままにしない

お気軽にご相談ください

お見積りへ お問い合わせへ
▲