Um block theme do WordPress é um tema construído inteiramente com blocos. Cada template (header, footer, post, arquivo, 404, busca) é armazenado como um arquivo HTML nas pastas /templates e /parts dentro do tema. Todo o site pode ser editado visualmente no Site Editor em /wp-admin/site-editor.php sem escrever PHP. Block themes foram introduzidos com o WordPress 5.9 (janeiro de 2022) e exigem um arquivo theme.json na raiz do tema que define estilos globais (cores, tipografia, espaçamentos, layout) em JSON. O primeiro block theme padrão foi o Twenty Twenty Two (janeiro de 2022), seguido por Twenty Twenty Three, Twenty Twenty Four e Twenty Twenty Five (janeiro de 2025). Full Site Editing (FSE) é o termo guarda chuva para a experiência de edição dos block themes: Site Editor, painel de estilos globais, edição de templates, template parts, bloco de Navegação, bloco Query Loop e o diretório de patterns em wordpress.org/patterns. Block themes convivem com temas clássicos (baseados em PHP, com header.php, footer.php, functions.php e Customizer). Ambos funcionam no WordPress 6.x, mas o desenvolvimento novo migrou para block themes desde 2022.
O que mudou no WordPress 5.9 (janeiro de 2022)?
- O Site Editor substitui o Customizer para block themes.
- Templates são arquivos HTML com marcação de blocos (
<!-- wp:paragraph -->), não PHP. - O novo arquivo
theme.jsondefine estilos globais. - Áreas de widgets são substituídas por template parts e o bloco de Navegação.
- O bloco Query Loop substitui loops WP_Query personalizados em templates na maioria dos casos.
Estrutura de arquivos de um block theme
meu-tema/
style.css
theme.json
functions.php
templates/
index.html
single.html
page.html
archive.html
404.html
search.html
parts/
header.html
footer.html
sidebar.html
patterns/
hero.php
assets/
fonts/, images/, css/, js/O que o theme.json controla?
- settings.color.palette: a paleta de cores.
- settings.typography.fontFamilies: famílias de fontes com font face embutido. Desde o WordPress 6.5 (abril de 2024) a Font Library instala fontes do Google Fonts localmente.
- settings.spacing: presets de espaçamento.
- settings.layout: contentSize e wideSize.
- styles: estilos padrão globais e por bloco.
- customTemplates: templates adicionais para o editor de páginas.
- templateParts: declara quais parts estão disponíveis.
Block theme contra tema clássico
| Aspecto | Tema clássico | Block theme |
|---|---|---|
| Templates | arquivos PHP | arquivos HTML com marcação de blocos |
| Personalização | Customizer | Site Editor e estilos globais |
| Menus | wp_nav_menu() | bloco de Navegação |
| Widgets | register_sidebar() | template parts e blocos |
| Estilos globais | CSS | theme.json |
| Edição | editor de código ou Customizer | Site Editor visual |
Temas híbridos e block template parts
Entre temas clássicos e block themes completos existem os temas híbridos que adotam FSE por etapas: adicionar theme.json, usar block_template_part() ou incluir templates HTML em templates/ para rotas específicas mantendo PHP no resto.
Patterns e o diretório de patterns
Patterns são layouts reutilizáveis. Desde o WordPress 6.0 (maio de 2022) os temas podem entregar patterns como arquivos PHP em patterns/. O diretório wordpress.org/patterns tem mais de 600 patterns da comunidade. Synced Patterns (antes Reusable Blocks, renomeados no WordPress 6.3 agosto de 2023) guardam uma instância única replicada em todos os usos.
Block themes e desempenho
- O WordPress só carrega folhas de estilo dos blocos realmente usados em uma página (desde o WordPress 5.8 agosto de 2021).
theme.jsongera um bloco CSS inline por página (5 a 15 KB).- Os blocos de Navegação e Query Loop são renderizados no servidor.
- Twenty Twenty Four alcança ~99 no PageSpeed Mobile em instalação base.
Block themes populares em 2025
- Twenty Twenty Five: tema padrão do WordPress 6.7 (novembro de 2024).
- Twenty Twenty Four: tema de propósito geral de janeiro de 2024.
- Blocksy, Kadence, Ollie, Frost, Spectra One, Inspiro.
Migrando de um tema clássico para um block theme
- Audite o tema clássico.
- Escolha um block theme base ou gere um novo com
npx @wordpress/create-block-theme. - Migre o design system para
theme.json. - Recrie templates em
templates/. - Recrie header e footer como template parts.
- Converta loops PHP em bloco Query Loop ou blocos dinâmicos.
- Teste em staging.
O que o InspectWP verifica
O InspectWP detecta qual tema está ativo, incluindo block themes, o tema pai e filho e se o tema tem problemas de segurança conhecidos. O relatório sinaliza temas desatualizados, suportes ausentes e sinais como falta de theme.json no WordPress 6.x que sugerem um tema clássico.