Base de Conhecimento

Tema filho WordPress: o que é e como criar

  • wordpress, tema filho, child theme, style.css, functions.php
  • Usuários acharam útil: 0

Entenda por que o tema filho guarda as suas mudanças longe das atualizações do tema pai, quando ele faz falta e como criar, ativar e sobrescrever arquivos.

Por Redação Eleven Host · @robson.direitodigital · 20 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Tema filho WordPress: o que é e como criar

Capa da Redação Eleven Host para o guia: Tema filho WordPress: o que é e como criar Arte: Eleven Host

Um tema filho WordPress é um tema que herda o visual e as funções de outro tema, o tema pai, e guarda as suas mudanças à parte. Assim, quando o tema pai recebe uma atualização, o que você alterou no tema filho continua lá.

Não copie o functions.php do tema pai para dentro do tema filho. A documentação do WordPress avisa que os dois arquivos são carregados e que nomes de função repetidos podem causar erro fatal.

O que é um tema filho

Pelo manual de temas do WordPress, um tema filho estende um tema pai: ele herda o desenho e as funções do pai e acrescenta só o que você quer mudar. O objetivo é personalizar sem editar os arquivos do tema pai.

Quem edita direto os arquivos do tema pai pode perder essas mudanças na próxima atualização dele.

Na montagem do site, o manual descreve as camadas que formam o site: o próprio WordPress, o tema pai, o tema filho e, por cima, as personalizações feitas pelo usuário. Em temas de bloco, essas personalizações do usuário ficam guardadas no banco de dados, e não nos arquivos do tema.

Quando o tema filho é necessário e quando não é

O tema filho entra quando você precisa mexer em arquivos do tema: trocar um template, acrescentar código PHP ou manter uma folha de estilo própria. Para o código PHP, a documentação aponta o functions.php do tema filho como lugar melhor que o do pai, porque a atualização do pai não o remove.

Para ajustes de visual menores, o WordPress tem caminhos sem tema filho:

  • Personalizador (Appearance > Customize): a documentação diz que, se o tema for atualizado, as mudanças feitas por ele ficam preservadas, ao contrário das feitas direto nos arquivos. Ele tem o painel Additional CSS, que acrescenta CSS por cima do tema atual. Pela mesma página, ele só aparece se o tema ativo tiver suporte e fica escondido em temas de bloco, salvo se um plugin precisar dele.
  • Estilos do editor do site: em temas de bloco, o theme.json é uma peça básica, e a documentação diz que o usuário pode personalizar o desenho pela interface de Estilos (Styles). Quando o tema e o usuário definem o mesmo estilo, vale o do usuário.

No outro extremo, a documentação faz um alerta: quando a personalização fica muito grande, o tema filho pode ficar difícil de manter, e ela sugere transformar o tema pai num tema próprio. Recomendamos olhar o tamanho da mudança antes de escolher o caminho.

A VPS consta no catálogo como servidor virtual privado. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

Antes de começar

Para criar o tema filho à mão, você precisa de acesso aos arquivos do site, por um gerenciador de arquivos ou por um programa de transferência de arquivos, e de um usuário administrador no painel do WordPress.

Recomendamos ensaiar numa cópia do site antes de ativar o tema filho no site no ar. O artigo Staging WordPress: como criar um site de teste mostra como montar essa cópia.

Anote também o nome exato da pasta do tema pai, dentro de wp-content/themes, como ela aparece no gerenciador de arquivos, e não o nome mostrado no painel. Ele vai ser usado no cabeçalho do tema filho.

Como criar um tema filho à mão

Os passos abaixo seguem a página de temas filhos do manual de temas do WordPress, que usa como exemplo um tema chamado Grand Sunrise, filho do Twenty Twenty-Four. Nenhum dos exemplos foi testado no seu site: confira cada linha no seu próprio ambiente.

1. Crie a pasta do tema filho

Dentro de wp-content/themes, crie uma pasta nova. A documentação pede o nome em letras minúsculas, com as palavras separadas por hífen, como grand-sunrise.

2. Crie o style.css com o cabeçalho

Dentro da pasta nova, crie o arquivo style.css. Pela documentação, ele é o único arquivo obrigatório para o tema filho existir. Ele começa com um cabeçalho em forma de comentário. O campo que faz dele um tema filho é o Template: ele diz ao WordPress qual é o tema pai. Um exemplo, com os dados do manual (confira no seu site o nome da pasta do seu tema pai):

/**

* Theme Name: Grand Sunrise

* Template: twentytwentyfour

*/

O valor de Template tem de ser igual ao nome da pasta do tema pai dentro de wp-content/themes, letra por letra. A página sobre o style.css lista os demais campos do cabeçalho, como autor, descrição, versão e licença.

3. Carregue a folha de estilo no functions.php, se for o caso

O functions.php é opcional no tema filho. A documentação descreve os casos:

  • se o tema pai já carrega a folha de estilo dele e a do filho, o tema filho não precisa fazer nada;
  • se o tema pai não carrega folha de estilo, como o Twenty Twenty-Four, o tema filho carrega o próprio style.css no functions.php;
  • se o tema pai carrega só a folha do tema ativo, a do filho já entra, e dá para carregar também a do pai.

Para saber em qual caso você está, a documentação manda olhar o código do tema pai. Em tema de bloco, ela acrescenta que carregar o style.css muitas vezes é desnecessário, porque o estilo desses temas geralmente fica no theme.json.

Na pasta do tema filho, crie o arquivo functions.php. Um exemplo de functions.php para o caso do tema pai que não carrega folha de estilo, com os nomes do manual (confira no seu site):

<?php

add_action( 'wp_enqueue_scripts', 'grand_sunrise_enqueue_styles' );

function grand_sunrise_enqueue_styles() {

wp_enqueue_style( 'grand-sunrise-style', get_stylesheet_uri() );

}

Quando o tema pai carrega só a folha do tema ativo, a documentação usa a mesma estrutura, com get_parent_theme_file_uri( 'style.css' ) no lugar de get_stylesheet_uri().

Se o seu tema filho tiver outro nome, troque o prefixo grand_sunrise nos dois lugares em que ele aparece no nome da função, para não repetir o nome de uma função do tema pai.

4. Ative o tema filho

Com a pasta dentro de wp-content/themes, o tema filho aparece na tela de temas do painel (Appearance > Themes), onde fica o botão de ativar (Activate). Se você montou o tema no computador, a documentação indica compactar a pasta em zip e enviar pela opção de adicionar tema (Appearance > Themes > Add New) antes de ativar.

Para a troca no site no ar, o artigo Modo de manutenção WordPress: como ativar e sair mostra como exibir um aviso aos visitantes.

Como o tema filho sobrescreve o tema pai

O functions.php do tema filho não substitui o do pai. Pela documentação, os dois são carregados, e o do filho vem logo antes do do pai.

Com templates, partes de template e padrões (patterns) é diferente: para trocar um arquivo do pai, crie no tema filho um arquivo com o mesmo nome. Recomendamos colocá-lo no mesmo lugar em que está no tema pai. No caso dos padrões, a documentação pede também o mesmo Slug registrado. O tema filho pode ainda ter templates, partes e padrões novos.

Se o seu tema filho cresceu em CSS, o artigo Minificar CSS e JavaScript: como deixar o site leve trata de deixar esses arquivos menores.

Tema filho de bloco com o plugin Create Block Theme

Para temas de bloco, há o plugin Create Block Theme, publicado no diretório de plugins do WordPress.org pela conta WordPress.org. Pela página dele, entre as funções estão criar um tema filho do tema ativo, exportar o tema em zip e salvar no tema ativo os templates e estilos alterados no editor.

Depois de instalado, ele aparece no editor do site, num ícone ao lado do botão de salvar. A opção de criar tema filho (Create Theme > Create Child Theme) gera um tema filho com o tema ativo como pai, incluindo as mudanças que você já fez. A página pede WordPress 6.8 ou mais novo e PHP 7.4 ou mais novo.

A própria página avisa que as mudanças podem alterar o site ou o tema de forma permanente e pede certeza antes de salvar. Recomendamos usar o plugin primeiro numa cópia do site.

Erros a evitar

  • Template com o nome errado: o valor precisa ser igual ao nome da pasta do tema pai. Usar o nome de exibição do tema, em vez do nome da pasta, não atende ao que a documentação pede.
  • functions.php copiado do pai: os dois arquivos são carregados, e funções com o mesmo nome podem causar erro fatal.
  • CSS carregado duas vezes: se o tema pai já carrega a folha dele e a do filho, o tema filho não precisa fazer nada. Confira no código do tema pai o que ele já carrega.

Checklist do tema filho

  • nome exato da pasta do tema pai anotado;
  • pasta nova em wp-content/themes, com nome em minúsculas e hífen;
  • style.css com o cabeçalho, incluindo Theme Name e Template;
  • functions.php só se o tema pai não carregar a folha do filho ou se houver código PHP;
  • nenhuma função copiada do functions.php do pai;
  • ensaio numa cópia do site antes de ativar no site no ar.

Notas sobre cada arquivo alterado

Recomendamos manter, dentro do tema filho, uma lista dos arquivos do tema pai que foram sobrescritos e o motivo de cada troca.

Nome e extensão escolhidos formam o domínio do site. Buscar domínio

Perguntas frequentes

Atualizar o tema pai apaga o tema filho?

Não. Pela documentação, o tema filho existe justamente para que a atualização do tema pai não apague as suas mudanças, que ficam em arquivos separados.

Preciso de tema filho para mudar só algumas cores?

Depende do caso. Em temas de bloco, a interface de Estilos do editor permite personalizar o visual. Em temas com suporte ao Personalizador, há o painel Additional CSS.

Posso criar um tema filho de um tema filho?

Não. A documentação diz que o WordPress não aceita tema neto: a hierarquia tem só o tema pai e o tema filho.

O tema filho precisa de functions.php?

Não. O único arquivo obrigatório é o style.css. O functions.php entra para carregar a folha de estilo, quando o tema pai não faz isso, ou para acrescentar código PHP.

Esta resposta lhe foi útil?

Artigos Relacionados