Atualizar o WordPress sem quebrar o site: a ordem em 5 passos
A ordem das etapas, o que checar antes de clicar em cada botão e as três saídas para quando o site cai no meio do processo.

Resposta curta: atualize nesta ordem: confirme a compatibilidade de PHP e as versões mínimas, gere um backup que você sabe restaurar, atualize o core, depois os plugins um a um e o tema por último. Se a tela ficar branca, entre pelo Modo de Recuperação enviado ao e-mail de administração do site.
Neste artigo
- Do mais baixo para o mais alto: a sequência em cinco etapas
- Checar PHP e as versões mínimas antes de clicar em atualizar
- Como saber se o backup de arquivos e banco realmente dá para restaurar
- Por que o core do WordPress vem antes de plugin e tema
- Atualizar os plugins um a um é o que dá nome ao culpado
- O tema por último, e por que criar o tema-filho antes
- Três saídas para a tela branca, nesta ordem
- O que automatizar e o que continuar fazendo com a mão
Site que quebra na atualização quase nunca quebra por causa do botão. Quebra por causa da ordem em que os botões foram clicados, e por não existir um caminho de volta quando a tela ficou branca.
A ordem que funciona, em cinco passos:
- Checar a versão de PHP do servidor e o PHP mínimo exigido pelos plugins e pelo tema.
- Fazer backup de arquivos e banco, e baixar o arquivo para a sua máquina.
- Atualizar o core do WordPress.
- Atualizar os plugins, um a um, testando o site entre cada um.
- Atualizar o tema por último, com tema-filho ativo.
A documentação oficial do WordPress descreve o procedimento de atualização e, antes dele, uma etapa de preparação: fazer backup do banco de dados e dos arquivos, verificar se o backup está bom e desativar os plugins (Updating WordPress). O que esse texto não faz é ordenar a tarefa completa do dia a dia, com plugins e tema no meio. É isso que está aqui.
Do mais baixo para o mais alto: a sequência em cinco etapas
A regra é atualizar do mais baixo para o mais alto: primeiro a plataforma, depois o que depende dela.
| Ordem | O que atualizar | Por que nessa posição | Como voltar atrás |
|---|---|---|---|
| 0 | Nada. Checar PHP e versões mínimas | Um plugin novo pode exigir PHP mais recente do que o servidor roda | Não se aplica |
| 1 | Backup completo (arquivos + banco) | É o único plano de volta que funciona para todos os casos | Restaurar |
| 2 | Core do WordPress | Plugins e temas são escritos contra a versão do core | Backup, ou atualização manual pelos arquivos |
| 3 | Plugins, um a um | Um a um você sabe qual quebrou | Desativar ou renomear a pasta do plugin |
| 4 | Tema (com tema-filho ativo) | O tema costuma ser o que mais depende de plugin e de core | Ativar tema padrão |
Se você atualiza tudo de uma vez e o site cai, o erro existe, mas não tem nome. Você vai passar a tarde descobrindo qual dos dezessete itens foi. Atualizando em ordem, o culpado é sempre o último que você clicou.
Checar PHP e as versões mínimas antes de clicar em atualizar
Plugin e tema declaram, no próprio pacote, a versão de PHP e de WordPress que exigem. Nas versões atuais do WordPress, quando o plugin declara Requires PHP acima do PHP que o servidor roda, o painel deixa de oferecer o link de atualização e mostra no lugar um aviso de incompatibilidade. Ou seja: no caminho normal, pelo painel, o próprio WordPress costuma te proteger. Não testei esse comportamento em todas as versões do core, então trate como rede de segurança e não como garantia.
O risco real aparece em duas situações. A primeira é o plugin (ou tema) que não declara esse cabeçalho: sem a informação, não há o que bloquear, a atualização instala e o erro fatal aparece na primeira página que usa o código novo. A segunda é a instalação por fora do painel, subindo o ZIP em Plugins > Adicionar novo > Enviar plugin ou copiando a pasta por FTP, onde a checagem não protege da mesma forma. Por isso vale olhar a ficha antes, mesmo com o painel fazendo a parte dele.
Onde ver a versão de PHP do seu site
No painel do WordPress, vá em Ferramentas > Saúde do site > Informações e abra o bloco Servidor. A linha da versão do PHP está ali. É a informação que o próprio WordPress lê do servidor, não um palpite.
Onde o plugin declara o PHP e o WordPress que exige
Abra a página do plugin no diretório oficial (wordpress.org/plugins/nome-do-plugin) e desça até a coluna de detalhes, do lado direito. Três linhas importam. Os rótulos abaixo são os que eu vejo na interface atual do diretório, em português do Brasil a tradução pode variar e a tela muda de tempos em tempos:
- WordPress Version: versão mínima do core (no readme do plugin, o campo se chama
Requires at least). - Tested up to: até qual versão do WordPress o autor testou.
- PHP Version: versão mínima do PHP no servidor (no readme,
Requires PHP).
Um exemplo fictício de ficha: PHP Version: 8.0 or higher. Se o seu servidor mostrar 7.4 em Saúde do site, esse plugin não deve ser atualizado antes de você subir o PHP. Em painéis como o cPanel a troca de versão de PHP é uma configuração por domínio, feita fora do WordPress, e é assunto de outra tarefa. Faça essa troca em dia separado, não no meio da atualização.
Se a coluna de detalhes não trouxer a linha PHP Version, o plugin não declarou nada. Aí o cuidado é seu: backup feito e teste logo depois de atualizar.
O que fazer quando o plugin exige PHP mais novo que o servidor
Duas saídas honestas: subir o PHP primeiro (e testar o site antes de atualizar qualquer plugin) ou deixar aquele plugin na versão atual por enquanto. Plugin travado numa versão antiga é risco de segurança, então isso é solução temporária, não decisão.
O tema também declara PHP mínimo, e isso se checa antes do core
O tema é o último a ser atualizado, mas a ficha dele se lê no começo, junto com a dos plugins. O motivo é prático: se o tema exige PHP mais novo do que o servidor roda, você vai descobrir isso depois de já ter atualizado core e plugins, com o site rodando em uma combinação que ninguém planejou.
Onde ver:
- Tema do diretório oficial: abra
wordpress.org/themes/nome-do-temae procure, na coluna de detalhes, as linhas de versão mínima do WordPress e de PHP. O campo nostyle.cssdo tema se chamaRequires PHP, do mesmo jeito que no plugin. - Tema comercial: a informação costuma estar na página de requisitos ou no changelog da versão nova, no site do autor. Se não estiver em lugar nenhum, pergunte antes de atualizar.
- Tema-filho ativo: quem declara requisito é o tema pai, que é o que você vai atualizar. O filho herda o ambiente, não o protege.
Se o tema pedir PHP acima do que Ferramentas > Saúde do site > Informações mostra no bloco Servidor, pare a atualização inteira ali. Subir o PHP é uma tarefa separada, com teste do site depois, e só então você recomeça pelo passo do backup.
Como saber se o backup de arquivos e banco realmente dá para restaurar
A documentação oficial pede explicitamente para verificar se o backup é bom antes de atualizar. Verificar não é ver o arquivo na lista. É saber onde ele está, o que tem dentro e o que você faria com ele.
Um backup útil para atualização tem duas partes:
- Arquivos: a pasta pública do site, principalmente
wp-content(tema, plugins, uploads) e owp-config.php. - Banco de dados: um dump
.sql. Sem ele, você recupera o visual e perde posts, páginas e configurações.
Se você usa o backup do painel de hospedagem, baixe o arquivo para a sua máquina antes de mexer no site. Backup que só existe no mesmo servidor que você vai alterar é meio backup.
Um teste rápido de confiança, e ele vale a hora que leva: abra o .sql num editor de texto e confirme que aparece o nome das tabelas do seu site (normalmente com um prefixo, algo como wp_posts). Se o arquivo estiver vazio ou com poucos kilobytes, o backup falhou e você descobriu isso no dia certo.
Plugin de backup dentro do WordPress funciona, com uma ressalva: se o site cair, o plugin cai com ele. Por isso o download do arquivo importa.
Por que o core do WordPress vem antes de plugin e tema
O core é a base. Plugins e temas são escritos para funcionar com determinada versão dele, então atualizar plugin novo em core antigo é pedir incompatibilidade.
Atualizar o core pelo painel, em um clique
Vá em Painel > Atualizações. Se houver uma versão nova, clique em Atualizar agora. Durante o processo o WordPress coloca o site em modo de manutenção e volta sozinho ao fim. A documentação oficial chama esse caminho de atualização de um clique e ele é o recomendado para a maioria dos sites.
Depois que a tela de boas-vindas da nova versão aparecer, faça uma volta rápida: abra a home, um post interno, uma página de contato e o painel. Só então siga para os plugins.
Atualização manual do core, quando o painel não conclui
Quando a atualização de um clique falha (permissão de arquivo, timeout, tela presa em manutenção), a documentação oficial descreve o caminho manual. O resumo, na ordem que ela indica:
- Backup de arquivos e banco, verificado.
- Desativar os plugins.
- Baixar o pacote do WordPress em
wordpress.orge descompactar no seu computador. - No servidor, apagar as pastas
wp-adminewp-includesantigas. - Subir as pastas
wp-adminewp-includesnovas. - Copiar os arquivos que estão dentro da pasta
wp-contentdo pacote novo por cima da suawp-contentexistente, sobrescrevendo o que tiver o mesmo nome. Não apague awp-contentantiga e não apague nada dentro dela. - Subir os arquivos soltos da raiz do pacote novo, sobrescrevendo os antigos. Não sobrescreva nem apague o
wp-config.php. - Abrir o painel. Se ele pedir atualização do banco de dados, confirmar.
- Reativar os plugins.
Se o site ficar preso na mensagem de manutenção, existe um arquivo .maintenance na raiz da instalação. Apagar esse arquivo pelo Gerenciador de Arquivos libera o site. Ele é criado no início da atualização e removido no fim, então ele sobrando significa que o processo parou no meio.
Atualizar os plugins um a um é o que dá nome ao culpado
A tentação é marcar todos e clicar em atualizar. O custo dessa economia de tempo aparece depois, quando o site quebra e você não sabe qual foi.
Procedimento, em Plugins > Plugins instalados:
- Atualize um plugin.
- Abra o site em outra aba e recarregue a home e uma página que use aquele plugin (formulário, loja, galeria, cache).
- Se estiver tudo de pé, volte e atualize o próximo.
Comece pelos plugins que outros dependem: cache, segurança, construtor de páginas, e-commerce. Deixe para o fim os pequenos e isolados.
Dois cuidados específicos:
- Plugin de cache: limpe o cache depois de atualizar. Muita "quebra" após atualização é página velha em cache misturada com arquivo novo. Antes de sair diagnosticando, limpe o cache e recarregue com Ctrl+F5.
- Plugin pago sem licença ativa: ele pode simplesmente não oferecer atualização. Não force por FTP sem ler a orientação do autor.
Plugin desativado há meses e que você não usa mais: desinstale em vez de atualizar. Menos código, menos superfície de erro.
Ensaio de rollback: voltar só o plugin
Restaurar o backup inteiro por causa de um plugin é desproporcional: você perde os comentários, os pedidos e os posts feitos desde o backup. Dá para voltar só a pasta daquele plugin, e vale ensaiar isso uma vez num plugin inofensivo, antes de precisar com a loja fora do ar. Numa instalação comum o ensaio leva poucos minutos pelo Gerenciador de Arquivos. Não cronometrei em site com wp-content grande, onde compactar a pasta demora mais.
Antes de clicar em atualizar o plugin crítico:
- No Gerenciador de Arquivos, entre em
wp-content/plugins. - Clique com o botão direito na pasta do plugin e escolha Compress para gerar um
.zipdela. - Baixe esse
.zippara a sua máquina e só então volte ao painel e atualize.
Se a versão nova quebrar o site:
- Renomeie a pasta nova do plugin, em
wp-content/plugins, acrescentando um sufixo ao nome (nome-do-plugin-off), como descrito mais adiante em Renomear a pasta do plugin. O site volta. - Envie o
.zipque você baixou para dentro dewp-content/pluginse use Extract. - Confirme que a pasta extraída tem o nome original do plugin, sem sufixo.
- No painel, o plugin aparece de novo na lista, na versão antiga. Ative.
- Apague a pasta
-offquando o site estiver de pé e testado.
Se você não guardou a cópia, o diretório oficial ainda tem saída: na página do plugin, o bloco Advanced View lista as versões anteriores para download. Isso só existe para plugin do repositório oficial. Para plugin pago, a versão antiga costuma estar na área de cliente do autor, e é por isso que a cópia local importa mais nesse caso.
Plugin voltado para a versão antiga é parada provisória: ele continua sem as correções novas. Avise o autor do erro que você viu no debug.log e atualize quando sair a correção.
O tema por último, e por que criar o tema-filho antes
O tema é o que mais encosta em tudo: usa funções do core, hooks de plugins, arquivos de template. Ele vai por último porque precisa encontrar o resto já atualizado.
O risco real do tema não é quebrar. É apagar. Se você editou arquivos do tema principal (adicionou código no functions.php, mudou um single.php), a atualização substitui esses arquivos pelos originais do autor e o seu trabalho vai embora sem aviso.
Saída correta: tema-filho. Ele é uma pasta separada que herda tudo do tema principal e guarda só as suas modificações. Quando o tema principal é atualizado, o filho continua intacto. Se o site tem personalização em arquivo e não tem tema-filho, crie o filho antes de atualizar o tema, ou pelo menos baixe uma cópia dos arquivos que você editou.
Atenção a um detalhe de ordem que pega gente: com tema-filho ativo, você atualiza o tema principal (o pai). O filho normalmente não recebe atualização, porque quem escreveu ele foi você ou a sua agência. Um filho que depende de função removida no pai quebra na atualização do pai, e é por isso que a checagem pós-clique importa.
Depois de atualizar o tema, confira o que os autores raramente citam nos changelogs: menus, widgets, área de rodapé e os modelos de página. São os pontos que mais mudam de lugar.
Três saídas para a tela branca, nesta ordem
Tela branca (ou "Houve um erro crítico neste site") significa erro fatal de PHP. O site não está perdido, só está sem saída pelo navegador. Tente nesta ordem.
Modo de Recuperação pelo e-mail de administração do site
Quando um plugin ou tema causa erro fatal, o WordPress envia um e-mail para o endereço de administração do site com um link de Modo de Recuperação. Esse link abre o painel com o item problemático pausado, e o e-mail indica qual arquivo disparou o erro.
Duas coisas para confirmar hoje, antes de precisar:
- Em Configurações > Geral, veja o campo Endereço de e-mail de administração. É para lá que o link vai. Se for uma caixa que você não abre, troque.
- Se o e-mail não chegar, olhe a pasta de spam. Se ainda assim não chegar, siga para os passos 2 e 3, que não dependem de e-mail.
Dentro do Modo de Recuperação, desative o plugin apontado, saia do modo e teste o site.
Ligar o log no wp-config.php e ler o arquivo culpado no debug.log
Sem e-mail e sem painel, o caminho é o log. Ele exige editar o wp-config.php, e esse é o arquivo mais sensível da instalação: uma aspa, um ponto e vírgula ou um parêntese fora do lugar derruba o site inteiro, inclusive as páginas que ainda estavam funcionando.
Antes de digitar qualquer coisa, baixe uma cópia do wp-config.php para a sua máquina. No Gerenciador de Arquivos do painel de hospedagem, clique com o botão direito no arquivo e escolha Download. Se o site piorar depois da edição, você sobe essa cópia de volta por cima e volta exatamente ao estado anterior.
Com a cópia salva, edite o wp-config.php pelo Gerenciador de Arquivos (ou por FTP) e, acima da linha que diz /* That's all, stop editing! */, coloque:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Linha por linha: a primeira liga o modo de depuração; a segunda manda os erros para um arquivo; a terceira impede que o erro apareça na tela para os visitantes. Copie as três linhas inteiras, sem digitar por cima, e salve.
Recarregue a página que quebrou e abra wp-content/debug.log. A última linha do arquivo é a mais recente. Você vai ler algo no formato de um erro fatal com o caminho do arquivo, e esse caminho tem o nome da pasta do plugin ou do tema culpado. Exemplo do que se lê nesse tipo de linha: PHP Fatal error ... in /home/usuario/public_html/wp-content/plugins/nome-do-plugin/arquivo.php.
Copie o caminho, resolva o problema e volte WP_DEBUG para false. Log ligado em produção cresce sem parar e pode expor caminho de servidor.
Renomear a pasta do plugin para desativá-lo sem painel
Com o nome do culpado em mãos, e sem acesso ao painel, você desativa o plugin por fora. No Gerenciador de Arquivos do painel de hospedagem:
- Entre na pasta pública do site (costuma ser
public_html) e depois emwp-content/plugins. - Clique com o botão direito na pasta do plugin problemático e escolha Rename.
- Acrescente um sufixo ao nome, por exemplo
nome-do-plugin-off. - Recarregue o site.
O WordPress não encontra mais o plugin naquele caminho e o desativa sozinho. O site volta. Ao entrar no painel você vai ver um aviso de que o plugin foi desativado por não ter sido encontrado, o que é exatamente o esperado.
Se nem isso resolve, renomeie a pasta plugins inteira para plugins-off: todos os plugins caem juntos. Site de pé com todos os plugins fora significa que o problema está em plugin. Site ainda quebrado significa tema ou core, e aí você troca o tema ativo pelo padrão, renomeando a pasta do tema em wp-content/themes da mesma forma.
Quando o problema não é tela branca e sim erro 500 sem mensagem, o log do servidor (e não só o debug.log) costuma ter a linha que falta. Esse é um diagnóstico à parte, com outros suspeitos, como limite de memória e .htaccess.
O que automatizar e o que continuar fazendo com a mão
O WordPress aplica sozinho atualizações de segurança e manutenção no core. Para plugins e temas, a automação é item por item, e o lugar de ligar é diferente em cada um:
- Plugins: em Plugins > Plugins instalados, a lista tem uma coluna Atualizações automáticas na direita. Cada linha traz o link Ativar atualizações automáticas ou Desativar atualizações automáticas.
- Temas: não existe essa coluna. Vá em Aparência > Temas, clique no tema desejado para abrir o painel de detalhes e use Ativar atualizações automáticas, no canto do bloco de informações.
Um arranjo conservador que funciona bem para site de conteúdo:
| Item | Automático | Manual |
|---|---|---|
| Segurança/manutenção do core | Sim | - |
| Versão maior do core | - | Sim, com backup antes |
| Plugins críticos (loja, formulário, cache, construtor) | - | Sim, um a um |
| Plugins simples e estáveis | Sim | - |
| Tema | - | Sim, por último |
Duas práticas que evitam a maior parte dos sustos:
- Atualize em horário de baixo movimento e num dia em que você tenha tempo de resolver. Atualização às 18h de sexta é decisão, não acidente.
- Anote o que atualizou e quando. Um arquivo de texto com data e nome dos plugins responde sozinho a pergunta "o que mudou desde que o site estava bom".
E o caso em que vale não atualizar agora: plugin abandonado, sem atualização há muito tempo, que sustenta uma função essencial do site. Ali o trabalho não é clicar em atualizar, é procurar substituto e migrar com calma. Atualizar o resto em volta dele e deixá-lo travado é remendo, e remendo tem prazo.
Se alguma etapa acima te trancou fora do painel antes de você chegar no Modo de Recuperação, o caminho é redefinir a senha de administrador por fora do WordPress. Também é tarefa separada, e não precisa envolver restaurar backup.
Referências
- Documentação oficial do WordPress — Updating WordPress. Consultado em 2026-09-16.