Block Template

Block Template WordPress é a estrutura base de uma página, post ou Custom Post Type definida inteiramente em blocos Gutenberg, no padrão Full Site Editing introduzido com o WordPress 5.9 em 2022. Em vez de templates PHP tradicionais, o site é montado por arquivos HTML compostos de blocos, editáveis no próprio painel sem código. É a evolução natural do WordPress como plataforma e o futuro inevitável de qualquer projeto novo no CMS.

O que é um Block Template

Um block template é o arquivo que define como um tipo de conteúdo será renderizado: header, área de conteúdo, sidebar, footer, tudo composto por blocos Gutenberg. Templates ficam na pasta /templates/ do tema e são editáveis via interface do Site Editor (Aparência → Editor) sem precisar abrir IDE ou FTP.

Diferente dos templates PHP clássicos do WordPress (single.php, page.php, archive.php), block templates são arquivos HTML com markup de blocos no padrão Gutenberg. Cada bloco vira um trecho HTML com comentário de identificação tipo <!– wp:paragraph –>. O sistema interpreta esses comentários e renderiza os blocos correspondentes em PHP.

O conceito faz parte do que o WordPress chama de Full Site Editing (FSE). Antes do FSE, o usuário só editava o conteúdo das páginas. Com FSE, edita também o template inteiro: cabeçalho, rodapé, layout das listagens, tudo via blocos. É democratização real do design, sem dependência de desenvolvedor para mudanças visuais.

Para o template gutenberg funcionar, o tema precisa ser do tipo Block Theme. Temas como Twenty Twenty-Two, Twenty Twenty-Three, Twenty Twenty-Four, Frost, Blockbase, Tove e dezenas de outros são block themes nativos. Temas clássicos (Astra, GeneratePress, Kadence em modo classic) não suportam block templates totalmente, embora estejam migrando.

Como funcionam os Block Templates

O fluxo técnico é simples. Quando alguém acessa uma página WordPress, o core verifica qual template deve ser usado conforme a hierarquia clássica (single → singular → index). Se o tema for um block theme, em vez de carregar single.php, ele carrega single.html da pasta /templates/. O conteúdo HTML com markup de blocos é interpretado e renderizado.

Block templates wordpress podem usar Template Parts, que são pedaços reutilizáveis como header, footer e sidebar definidos em /parts/. Em vez de copiar o cabeçalho em todos os templates, você cria header.html uma vez e referencia em cada template via bloco wp:template-part. Mudanças no header se propagam automaticamente para todos os templates que o usam.

Os templates são organizados em hierarquia parecida com a clássica, com nomes específicos: index.html (fallback geral), single.html (post único), page.html (página estática), archive.html (listagens), 404.html, search.html. Você pode também criar templates customizados como single-product.html para WooCommerce ou page-landing.html para landings específicas.

Edição via Site Editor

O Site Editor (Aparência → Editor) é a interface visual para editar block templates. Você navega entre templates pelo menu lateral, abre cada um e edita exatamente como editaria uma página: adicionando blocos, modificando estrutura, ajustando cores e tipografia. As mudanças ficam salvas no banco de dados como override do template original do tema, deixando o tema intacto.

Como criar um Block Template

Existem três caminhos para criar um fse template. O primeiro é via Site Editor visualmente. No editor, vá em Templates → Adicionar Novo → escolha o tipo (single, archive, etc.), monte a estrutura com blocos e salve. O WordPress armazena o template como override no banco e ele passa a ser usado em vez do template padrão do tema.

O segundo é via código no tema. Crie a pasta /templates/ no tema (se não existir), adicione um arquivo .html com o markup de blocos. Exemplo de single-livro.html: defina o cabeçalho, área de conteúdo com blocos específicos, sidebar com livros relacionados, footer. O WordPress detecta o template automaticamente e usa para Custom Post Types do tipo “livro”.

O terceiro é exportar do Site Editor para arquivo. Após editar visualmente, use o exportador integrado do WordPress para baixar o tema com os templates atualizados como arquivos HTML. Isso permite versionar templates em Git, distribuir entre projetos e usar como base para temas filhos.

Para Custom Post Types, vale criar templates específicos. Em um site de portfólio com CPT “projeto”, criar single-projeto.html permite layout diferenciado (galeria de imagens grande, descrição rica, links para casos similares) em vez de usar o single.html genérico do tema. Combine com custom post type bem estruturado e a edição de site fica completamente visual.

Para inserir block pattern dentro de um template, basta abrir o catálogo no Site Editor e clicar. Patterns viram blocos no template e podem ser editados livremente. Combinar templates bem desenhados com biblioteca de patterns é a fórmula moderna para construir sites WordPress sem code.

Block Template vs Page Template

A confusão é comum em quem migra de WordPress clássico. Page Template é o conceito antigo: arquivos PHP com nomes específicos (page-contato.php, page-sobre.php) selecionáveis no painel ao editar uma página. Continua funcionando em block themes, mas em paralelo aos block templates.

Block Template é o conceito novo: arquivos HTML em /templates/ que definem estrutura via blocos. Editáveis no Site Editor sem programar. Substitui gradualmente os page templates clássicos em projetos novos baseados em FSE.

Em sites híbridos durante a migração, os dois coexistem. Páginas legadas continuam usando page templates PHP. Páginas novas usam block templates. Não há conflito, mas o ideal é unificar no longo prazo para reduzir manutenção. Combinar com Gutenberg bem dominado é o que torna a transição produtiva.

O WordPress está investindo pesado em Full Site Editing desde 2021. Em 2026, qualquer projeto novo nasce em block themes por default. Templates clássicos continuam suportados, mas o ecossistema (temas, plugins, agências) está alinhado com o caminho de blocos. Aprender block templates hoje é investimento em algo que vai ficar.

Para sites WordPress que precisam de tema com block templates já estruturados, biblioteca de patterns ampla e suporte completo a Full Site Editing, a FULL Services entrega o Astra PRO já licenciado dentro da stack profissional, com starter templates prontos para FSE e curadoria de plugins compatíveis. Em vez de testar tema por tema, você roda em base validada que dá produtividade desde o primeiro dia.