Theme Json
Styles Configuration
Complete reference for styles in theme.json.OverviewThe styles section defines CSS styling rules that WordPress applies globally and per-block.{ "styles": {...
Template Parts
Complete reference for templateParts in theme.json.OverviewThe templateParts array registers reusable template sections like headers, footers, and sidebars.{ "templateParts": [ {...
theme.json
Global settings and styles configuration for WordPress block themes.Since: 5.8.0 Current Schema Version: 3 Source: wp-includes/class-wp-theme-json.phpPurposetheme.json provides a centralized way...
CSS Generation
How WordPress generates CSS from theme.json configurations.OverviewWordPress processes theme.json and generates:CSS Custom Properties (variables) from settingsUtility Classes for presetsGlobal Styles...
Custom Templates
Complete reference for customTemplates in theme.json.OverviewThe customTemplates array registers custom page/post templates that users can select in the editor.{ "customTemplates":...
Patterns
Complete reference for patterns in theme.json.OverviewThe patterns array registers block patterns that are bundled with or referenced by your theme.{...
theme.json Schema Overview
The theme.json file is WordPress's unified configuration system for block themes, controlling global styles, editor settings, and theme behavior.File Locationtheme-root/...
Per-Block Settings
Complete reference for settings.blocks in theme.json.OverviewThe settings.blocks object allows you to override global settings for specific blocks.{ "settings": { "color":...
Color Settings
Complete reference for settings.color in theme.json.Overview{ "settings": { "color": { "background": true, "custom": true, "customDuotone": true, "customGradient": true, "defaultDuotone": true,...
Layout Settings
Complete reference for settings.layout in theme.json.Overview{ "settings": { "layout": { "contentSize": "650px", "wideSize": "1200px", "allowEditing": true, "allowCustomContentAndWideSize": true } }...
Other Settings
Complete reference for border, shadow, dimensions, position, background, appearance tools, custom properties, and other settings.appearanceToolsMeta-setting that enables multiple design tools...
Spacing Settings
Complete reference for settings.spacing in theme.json.Overview{ "settings": { "spacing": { "blockGap": null, "customSpacingSize": true, "defaultSpacingSizes": true, "margin": false, "padding": false,...