Curated resource guide
WordPress Block Theme Development Resources
Create block themes that work naturally with the Site Editor while retaining disciplined control over design and code. This guide covers theme.json, templates, patterns, style variations, responsive systems, accessibility, performance, and practical migration paths from classic or hybrid WordPress themes.
Scope
What this guide covers
- Block-theme architecture
- theme.json
- global styles and settings
- block templates
- template parts
- patterns
- synced patterns
- style variations
- block styles
- typography, spacing, color and layout controls
- Site Editor integration
- navigation
- query loops
- dynamic data
- block locking
- template editing permissions
- custom block styles
- CSS strategies
- design tokens
- responsive behaviour
- accessibility
- internationalization
- performance
- child block themes
- hybrid migration from classic themes
- testing
- debugging
- packaging and Theme Directory requirements
Selected references
Curated resources
Links open the original publisher so you can use the complete, current material in context.
- 01Recommended starting point
Block Theme Quick-Start Guide
A hands-on route into block themes using a current default theme and the Site Editor. It shows how visual changes relate to theme files and how to export an initial working theme.
developer.wordpress.org - 02
WordPress Theme Developer Handbook
The official home for modern and classic WordPress theme development. It links the full path from setup and structure through templates, styling, features, testing, and release.
developer.wordpress.org - 03
Theme Structure
A clear map of the standard files and folders WordPress expects in a theme. The page is especially helpful for seeing how templates, parts, patterns, styles, and theme.json fit together.
developer.wordpress.org - 04
Global Settings and Styles with theme.json
The central reference for controlling editor settings and generated styles through theme.json. It provides the foundation for consistent design tokens, block controls, layout, typography, color, and spacing.
developer.wordpress.org - 05
Block Theme Templates
A structured guide to block templates, hierarchy, custom templates, and reusable parts. It explains how block markup becomes the document structure rendered on the frontend.
developer.wordpress.org - 06
Block Theme Template Parts
Official guidance for building and registering reusable template sections such as headers, footers, and sidebars. It also explains how parts are referenced from top-level templates and theme.json.
developer.wordpress.org - 07
Block Patterns for Themes
A complete introduction to bundling reusable block layouts with a theme. It covers registration, file headers, categories, patterns from the directory, and how patterns support a coherent editing experience.
developer.wordpress.org - 08
Global Style Variations
A focused guide to shipping alternative theme.json designs from the styles directory. It explains what variations can change and how saved user customizations affect later theme updates.
developer.wordpress.org - 09
Block Stylesheets
WordPress guidance for loading CSS only where a particular block needs it. This is useful when theme.json cannot express a design and a single global stylesheet would add unnecessary frontend weight.
developer.wordpress.org