Full Site Editing, revisited

Block themes got a cold reception, and some of that was earned. But the thing people rejected in 2022 isn’t the thing that exists now.

Full Site Editing arrived to a fairly cold reception. It was rough early on, the learning curve was real, and a lot of developers who had spent a decade getting good at PHP templates were told their skills had been reorganised. Some of that frustration was earned.

It is worth revisiting, because the thing people rejected in 2022 is not the thing that exists now.

What actually changed for theme authors

The old model: a theme was PHP templates, a stylesheet, and a settings panel the author wrote and maintained. Every theme reinvented its own options framework. Users learned a new interface for every theme they bought.

The new model: a theme is mostly a theme.json file describing design tokens, plus HTML templates made of blocks. WordPress generates the CSS. The editing interface is the same one every block theme uses.

That last point is the underrated one. A user who learns to edit one block theme has learned to edit all of them. The knowledge transfers, which was never true of custom options panels.

theme.json is the actual product

Most of a block theme’s design lives in one JSON file: the colour palette, type scale, spacing scale, layout widths, and per-block style rules. It looks unglamorous and it is enormously powerful, because it means the design system is declared in one place rather than scattered across a stylesheet.

It also has sharp edges. Defining a font size with the same slug as a WordPress default will not override it unless you also disable the defaults: the theme’s value is silently dropped and core’s is used instead. That kind of thing is easy to ship without noticing, because nothing errors. It just quietly looks wrong.

Worth learning?

Yes, and increasingly it is not optional. Block themes are the way WordPress itself now recommends building a theme. More practically: building one takes less code than the PHP equivalent, and there is no options framework left to maintain.

The transition is genuinely a transition: old instincts do not all carry over. But the destination is a smaller, more standard, more maintainable theme, which is exactly what a small shop needs.