この記事は、theme.jsonに「どんなキーがあって、何ができるのか」をひと目で確認できるリファレンスとして作りました。
はじめに
💡 このページは「辞書」として使うことを想定しています。theme.jsonについてや、各キーの詳しい使い方は下のリンク記事をご覧ください。
【WordPress】theme.jsonって何？設定ファイル1つでサイトの見た目を統一する仕組み
【WordPress】CSSの書き方をtheme.jsonに「翻訳」する完全ガイド
キー構成の全体像
theme.json
├── $schema ← VSCode補完用（動作に影響なし）
├── version ← 必須。現在は 3
├── settings ← 「何を使えるようにするか」の設定
│ ├── color / typography / layout / spacing / border / shadow / custom
│ └── blocks ← ブロックごとに個別上書きも可能
├── styles ← 「実際にどんな見た目にするか」のCSS値
│ ├── color / typography / spacing
│ ├── elements ← h1〜h6・link・button など
│ └── blocks ← ブロックごとに個別スタイル
├── customTemplates ← カスタムテンプレートをエディターに登録
├── templateParts ← テンプレートパーツをエディターに登録
└── patterns ← WP公式パターンの登録
📖
WordPressの公式ドキュメント（英語）に全設定の一覧があります。
Theme.json リファレンス → developer.wordpress.org
折りたたみで入れ子を展開できる鳥瞰図
必須 必須キー
推奨 強く推奨
任意 任意
▶ クリックで展開