Glossário

O que é um block theme do WordPress (Full Site Editing)?

20 de maio de 2026

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.json define 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

AspectoTema clássicoBlock theme
Templatesarquivos PHParquivos HTML com marcação de blocos
PersonalizaçãoCustomizerSite Editor e estilos globais
Menuswp_nav_menu()bloco de Navegação
Widgetsregister_sidebar()template parts e blocos
Estilos globaisCSStheme.json
Ediçãoeditor de código ou CustomizerSite 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.json gera 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

  1. Audite o tema clássico.
  2. Escolha um block theme base ou gere um novo com npx @wordpress/create-block-theme.
  3. Migre o design system para theme.json.
  4. Recrie templates em templates/.
  5. Recrie header e footer como template parts.
  6. Converta loops PHP em bloco Query Loop ou blocos dinâmicos.
  7. 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.

Verifique seu site WordPress agora

O InspectWP analisa seu site WordPress em busca de problemas de segurança, problemas de SEO, conformidade com GDPR e desempenho — gratuitamente.

Analise seu site grátis