WordPressのオリジナルテーマを制作・適用したとき、投稿編集画面に「アイキャッチ画像」の設定パネルが表示されないことがあります。
この記事では、その原因と対処法を、「テーマ側の設定」と「エディタ側の表示設定」の2つの視点からまとめています。
原因は大きく分けて2つ
アイキャッチ画像が表示されない原因は、ほぼ以下のどちらかです。
① functions.php に必要な記述がない
テーマがアイキャッチ画像機能に対応することを宣言していないため、管理画面に設定箇所自体が現れない。
② エディタのパネル設定で非表示になっている
機能自体は有効なのに、ブロックエディタ（Gutenberg）の表示設定でパネルが隠れている。
対処法①：functions.php で機能を有効化する
まずはテーマ自体がアイキャッチ画像を使えるように設定します。functions.php に以下の記述があるか確認してください。
1. テーマ全体の機能を有効にする
以下のコードを追記することで、テーマにアイキャッチ画像機能が追加されます。
function my_theme_setup() {
// テーマがアイキャッチ画像に対応することを宣言
add_theme_support( 'post-thumbnails' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );2. カスタム投稿タイプを使っている場合
もし「お知らせ（news）」などのカスタム投稿タイプを使っている場合は、register_post_type() の supports パラメータに 'thumbnail' が含まれているか確認してください。
register_post_type( 'news', array(
'labels' => array( 'name' => 'お知らせ' ),
'public' => true,
'has_archive' => true,
'supports' => array( 'title', 'editor', 'thumbnail', 'excerpt' ), // 'thumbnail'が必要！
) );この2つが揃っていれば、テーマ側の設定は完了です。
対処法②：エディタのパネル表示設定を確認する
「コードは正しいはずなのにパネルが見当たらない」という場合は、エディタの表示設定（ユーザー設定）を確認します。
手順A：「投稿」タブを確認する
- 記事の編集画面を開く
- 右側のサイドバー上部にある 「投稿」タブ を選択しているか確認する （「ブロック」タブが選択されているとアイキャッチ画像は表示されません）
手順B：オプションから表示をオンにする
手順Aでも見当たらない場合は、パネルが非表示に設定されています。
- 編集画面右上の 「︙（縦三点リーダー）」 をクリック
- 一番下の 「設定」 を選択
- 左側のメニューから 「パネル」 をクリック
- 「アイキャッチ画像」のスイッチ をオンにする
手順C：ブラウザの再読み込み
設定変更が反映されない場合は、ブラウザを 再読み込み（Ctrl + F5 などでキャッシュクリア） してみてください。
まとめ：チェックリスト
| 原因 | 対処法 |
| add_theme_support がない | functions.php に追記して保存 |
| カスタム投稿の設定不足 | supports 配列の中に 'thumbnail' を追加 |
| パネルが非表示になっている | エディタ右上の「︙」→ 設定 → パネルから表示をON |
| 反映されない・表示が古い | ブラウザを強制再読み込みして確認 |
最後に：画像を表示した後は？
アイキャッチ画像を設定できたら、テーマファイル（index.php や single.php など）に <?php the_post_thumbnail(); ?> を記述して表示させます。
画像が大きすぎたり崩れたりする場合は、CSSで object-fit: cover; などを使ってサイズを調整してください。
オリジナルテーマ制作では、こうした細かい宣言が抜けがちです。アイキャッチ画像が表示されないときは、まずこのチェックリストを順番に確認してみてください。
