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やセキュリティ機能は除外設定で対応し、止めたままにしない