---
title: "What Is a WordPress Block Theme? The 2026 Build-and-Choose Guide"
url: https://nexterwp.com/blog/what-is-a-wordpress-block-theme/
date: 2026-06-05
modified: 2026-06-05
author: "Aditya Sharma"
description: "A WordPress block theme runs your whole site in the Site Editor. Here's what that means in 2026, how it works, and whether to build your own or pick one."
image: https://nexterwp.com/wp-content/uploads/2026/06/blocktheme-banner-1024x538.jpg
word_count: 1910
---

# What Is a WordPress Block Theme? The 2026 Build-and-Choose Guide

#### Key Takeaways
- A WordPress block theme is a theme built for the Full Site Editor. The header, footer, and every template are editable as blocks, and the layouts live in HTML files plus a theme.json file rather than in PHP.- Block themes are mainstream in 2026: the WordPress.org directory lists 1,643 of them, and WordPress 7.0 added device visibility and per-block CSS to the editor.- Build your own with the free Create Block Theme plugin (20,000+ installs) when you need full control. Choose a ready-made theme when you want speed and support.- Judge a block theme on theme.json depth, template coverage, performance, and block-plugin compatibility, not just on how the demo looks.- A lightweight block theme such as Nexter Theme, paired with a toolkit like Nexter Blocks, covers the design controls core still leaves out.
 

The first time I installed a fresh copy of WordPress and opened the theme directory, I hit a fork I did not expect. Two themes I liked sat side by side. One opened the old Customizer with its live preview pane. The other dropped me straight into a full-screen editor where the header itself was a block I could click and rearrange. The label on the second one said “block theme,” and I had no idea what I was signing up for.

If you are at that same fork, this guide is the answer I wish I had. We will define what a WordPress block theme actually is, look at how it works under the hood, check whether the technology is ready for real projects in 2026, and then settle the question that trips up most people: should you build your own block theme or choose an existing one?

Table of Contents

![WordPress.org developer documentation defining block themes](https://nexterwp.com/wp-content/uploads/2026/06/4MVZZUE6VW-W-37yRLoL5CddLLlTDSvMnSU4JKiHfREM0RLVw7GnTwlqEJLh2-mbSQX1YBTaAgyWFrWVEX6OOg-scaled.png)WordPress.org defines block themes as the modern method of building themes, built entirely out of blocks. Source: developer.wordpress.org.
***Also Read:** [WordPress Block Themes vs Classic Themes](https://nexterwp.com/blog/wordpress-fse-block-themes-vs-classic-themes/) if you want the full side-by-side breakdown.*

## What is a WordPress block theme?

A WordPress block theme is a theme built specifically for the Full Site Editor. With a block theme active, every visible part of your site, from the header and navigation down to the footer, is editable using the same block interface you already use to write a post. There is no separate Customizer for the header and no PHP file to open just to move a logo.

The official WordPress developer documentation describes block themes as “the modern method of building WordPress themes,” ones that are “built entirely out of blocks” and follow a standard set of conventions. That is the clean definition: a classic theme is a set of PHP files that generate your layout, and a block theme is a set of HTML templates plus a configuration file that the editor reads and lets you change visually.

The practical difference is who gets to edit the design. On a classic theme, changing the footer layout usually means editing footer.php or fighting the Customizer. On a block theme, you open the Site Editor, click the footer, and move the blocks. That shift is the whole point.

## How a block theme actually works

Three pieces do the heavy lifting in every block theme. Once you can name them, the rest of full site editing stops feeling like magic.

- **HTML templates.** Block themes store their layouts as HTML files inside a `templates` folder (think index, single, page, archive) and reusable pieces like the header and footer inside a `parts` folder. These files hold block markup, not PHP logic, which is why the editor can open and rewrite them safely.- **The theme.json file.** This single file defines your global settings and styles: the color palette, typography scale, spacing, and which controls are even available to editors. WordPress reads it and exposes those options in the Styles panel, so you adjust the whole site from one point-and-click interface instead of hunting through a stylesheet.- **The Site Editor.** This is the screen that ties it together. It loads your templates and theme.json, shows the real layout, and saves your changes back to the theme. You can even export a finished theme from here without touching code.
![WordPress theme handbook page showing block template files](https://nexterwp.com/wp-content/uploads/2026/06/USDYpLG9lQGFHBfrPSfSy09bX4M8eA9dByTYFj4bkQoBuwUjkknhYKZyqJ49c5IN6PJteD_bRO7z132u-Iuplw-scaled.png)Block themes store templates as HTML files in the templates and parts folders. Source: developer.wordpress.org.
 

## Block theme vs classic theme vs hybrid, in 60 seconds

You will meet three labels in the wild. A **classic theme** uses PHP templates and the Customizer; it is the format that ran WordPress for two decades. A **block theme** uses HTML templates, theme.json, and the Site Editor. A **hybrid theme** sits in the middle: a classic theme that opts into a few block features like template editing without going all in.

For a new 2026 project, the choice is usually block versus classic, and most new sites should start with a block theme. If you want the six concrete differences and where hybrids fit, our deeper [block themes versus classic themes](https://nexterwp.com/blog/wordpress-fse-block-themes-vs-classic-themes/) breakdown covers exactly that, so we will not repeat it here.

## 2026 status check: are block themes ready?

Short answer: yes, with eyes open. Block themes are no longer the experimental option they were when full site editing first shipped. As of June 2026, the WordPress.org theme directory lists **1,643 block themes** under its full-site-editing tag, and new block themes land there every week. This is now the default format the project builds toward.

![WordPress.org theme directory showing 1,643 block themes](https://nexterwp.com/wp-content/uploads/2026/06/SPEDS4aUVDGI0pHI_biOCgQMQ6x-A55wZU29ZOwgIFc9hnY9U78RmjAycdKwan4gOSOi95k9iQZAUhDammIb_g-scaled.png)The WordPress.org directory lists 1,643 block themes under the full-site-editing tag as of June 2026. Source: wordpress.org/themes.
The editor matured alongside the themes. [WordPress 7.0](https://nexterwp.com/blog/wordpress-7-block-builders/), released in May 2026, added device visibility controls and block-level custom CSS straight into the editor, two things block builders had asked core for since blocks existed. Performance is the quieter win: block themes do not load jQuery by default, they lean on native CSS instead of inline styles, and WordPress only serves the block styles a page actually uses. If speed is your concern, our [WordPress speed tips](https://nexterwp.com/blog/tips-to-speed-up-wordpress-websites/) pair well with a clean block theme.

There is an honest catch. The Site Editor still has a learning curve if you grew up on the Customizer, and not every theme.json is built to the same depth. That is why the build-or-choose decision below actually matters.

## Build or choose? The decision that actually matters

Once you understand block themes, the real question is not whether to use one. It is whether to build your own from scratch or choose a ready-made theme and customize it. Here is how that breaks down by situation.

| Your situation | Better path | Why |
| -------------- | ----------- | --- |
| Solo site, blog, or small business | Choose | A good ready-made block theme gets you live in an afternoon with support behind it. |
| Agency shipping many client sites | Choose a flexible base, then customize | One dependable block theme plus a toolkit scales better than rebuilding each time. |
| Highly custom brand or product site | Build | Full control over theme.json and templates is worth the extra hours. |
| Developer learning full site editing | Build a small one | Nothing teaches the structure faster than shipping one yourself. |

 

***Also Read:** [The state of full site editing](https://nexterwp.com/blog/state-of-fse-with-nexter/) for the bigger picture on where block-first building is headed.*

## How to build your own block theme

This is the part most “what is a block theme” guides skip, and it is easier than it sounds because you do not have to write the files by hand. The free [Create Block Theme](https://wordpress.org/plugins/create-block-theme/) plugin, maintained by WordPress.org with more than 20,000 active installs, turns the Site Editor into a theme-building tool. Here is the flow.

- **Install Create Block Theme** and activate it. A new panel appears next to the Save button in the Site Editor.- **Design in the editor.** Set your colors, fonts, and spacing in the Styles panel, then edit your header, footer, and templates visually.- **Save changes to the theme** or create a brand new one. The plugin can create a blank theme, clone the active theme with your changes, spin up a child theme, or save a new style variation.- **Inspect and export.** Use the built-in theme.json inspector to check your settings, then export the finished theme as a zip you can move between sites or hand to a client.
One honest warning from the plugin authors themselves: treat it like a development tool, because saved changes write to your theme files permanently. Work on staging first. Build your own when you need total control over the markup and the design system. For most people, the next option is faster.

![Create Block Theme plugin listing showing 20,000+ active installs](https://nexterwp.com/wp-content/uploads/2026/06/0sqh3yj3-HEfUCUNhu9xdDIu-aFfveIQQ1Lvb99Z2aPEXx7cAgfvU_W3tftzEop2oIfqC9CU4IAAcDmvyi0dZQ-scaled.png)The official Create Block Theme plugin (20,000+ installs) lets you build, export, and edit a block theme from inside the Site Editor. Source: wordpress.org/plugins.

## How to choose a block theme

Choosing is the right call for most sites, but a pretty demo is a weak reason to pick one. Judge a block theme on four things that decide how it behaves once your content is in:

- **theme.json depth.** A rich theme.json means more color, type, and spacing controls exposed in the editor, so you customize without custom CSS.- **Template coverage.** Check that it ships the templates you need (single, archive, search, 404) rather than just a home page.- **Performance.** Lightweight markup and minimal scripts keep your Core Web Vitals healthy.- **Block-plugin compatibility.** The theme should play nicely with whatever block toolkit you add for extra controls.
This is where [Nexter Theme](https://nexterwp.com/nexter-theme/) fits. It is a lightweight block theme built for the Site Editor, with a deep theme.json and broad template coverage, so you spend time designing instead of fighting defaults. If you want a shortlist of options to compare, our roundup of the [best WordPress block themes](https://nexterwp.com/blog/wordpress-block-themes-gutenberg/) walks through several.

![Nexter Theme landing page, a lightweight WordPress block theme](https://nexterwp.com/wp-content/uploads/2026/06/vw-JZsfIB227PUejgh7L0H7zySxn-ycsGmv3AXJ5G7mAH3XLUW2Dp6PiISLydniPmtZjRetZvkmtHERZl8N85w-scaled.png)Nexter Theme is a lightweight block theme built for the Site Editor. Source: nexterwp.com.
Whichever theme you choose, core only gives you the design primitives. Presets, dynamic content, motion effects, and a dynamic repeater block still live in a toolkit layer. That is the job [Nexter Blocks](https://nexterwp.com/nexter-blocks/) does, adding the finished controls on top of any block theme so you are not blocked by what core left out.

![Nexter Blocks landing page showing block editor toolkit features](https://nexterwp.com/wp-content/uploads/2026/06/vHQhJLNSoI8fNDxc2EaT4J4MGH5tIDD7RcrkJ5_3YwnieObkTUH6eg4uo03-fqoVBluG_isy24eP65uNcnN2hg-scaled.png)Nexter Blocks adds presets, dynamic content, and advanced controls on top of any block theme. Source: nexterwp.com.
 

## Common block-theme mistakes to avoid

- **Editing theme files directly on production.** Site Editor and Create Block Theme changes are permanent. Use staging.- **Judging a theme by its home page.** Test an archive and a single post before you commit; that is where thin themes fall apart.- **Ignoring theme.json.** If you are writing custom CSS for colors and spacing, you probably missed a setting the theme already exposes.- **Forgetting AI readers.** Answer engines now read your pages, and clean block structure is what gets you cited. We cover the file that helps in [llms.txt for Gutenberg WordPress](https://nexterwp.com/blog/llms-txt-gutenberg-wordpress/), and [RankReady](https://store.posimyth.com/plugins/rankready/) handles AI-search readiness end to end.

## The bottom line: which path for which builder

A WordPress block theme is simply a theme you edit with blocks instead of code, powered by HTML templates and a theme.json file inside the Site Editor. In 2026 it is the mainstream choice, with more than 1,600 options in the directory and a core editor that finally ships the controls builders wanted.

If you are a developer or running a heavily branded site, build your own with Create Block Theme and own every detail. If you are like most people and want to ship, choose a lightweight, well-built block theme such as Nexter Theme, add Nexter Blocks for the advanced controls, and keep your structure clean for both human readers and the AI engines now reading along. Either path is the right one. The wrong move is staying on a classic theme out of habit.

#### Stay updated with Helpful WordPress Tips, Insider Insights, and Exclusive Updates – Subscribe now to keep up with Everything Happening on WordPress!

Subscribe

[Start with Nexter Theme, a lightweight block theme](https://nexterwp.com/nexter-theme/)
 