Block Theme
A block theme is a WordPress theme whose templates and template parts are composed primarily of blocks.
Block themes work with the Site Editor and commonly use theme.json to configure settings, styles and design tokens.
A theme built around block-based templates
Block themes work with the Site Editor and commonly use theme.json to configure settings, styles and design tokens. In practical terms, Block Theme belongs to the publishing and site-management layer. Knowing that layer is important because it tells you what the term can change, what it cannot change, and where to look when something behaves unexpectedly.
Editing templates with blocks instead of PHP files
A block theme can define templates and template parts with blocks and theme.json instead of relying only on traditional PHP template files.
Where site editing replaces older theme patterns
You do not need to memorize the term in isolation. It becomes useful when you can recognize it in the tool, browser, file or conversation where the concept is doing real work.
Block Theme and Block Editor are different layers
A block theme is a WordPress theme whose templates and template parts are composed primarily of blocks. By contrast, The WordPress Block Editor is the editing interface that represents page and post content as individual blocks. The two can appear in the same project, but they describe different parts of the work and should not be used as interchangeable labels.
The mistake: assuming every theme supports the same editing model
The common mistake is to use Block Theme as if it also meant Block Editor. That blurs two separate decisions and usually sends troubleshooting in the wrong direction. A better test is practical: Check whether the active theme is block-based before looking for classic-theme files such as header.php or footer.php.
Why block themes move layout into the editor
In day-to-day work, Block Theme matters when the concept needs to be identified precisely instead of being grouped with a nearby term. The practical value is not the vocabulary itself; it is being able to identify the right control, file, setting or decision when the concept becomes relevant.
A block theme can define templates and template parts with blocks and theme.json instead of relying only on traditional PHP template files. That example is useful because it turns the definition into something you can recognize, test and discuss with other people working on the same project.
Related terms worth learning next
Sources and further reading
Use these references when you need documentation-level detail, specifications or product-specific behavior beyond the plain-English explanation above.