blog
WordPress

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.

JR · · 16 min de leitura · 2 tabelas · 1 bloco de código

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
  1. Do mais baixo para o mais alto: a sequência em cinco etapas
  2. Checar PHP e as versões mínimas antes de clicar em atualizar
  3. Como saber se o backup de arquivos e banco realmente dá para restaurar
  4. Por que o core do WordPress vem antes de plugin e tema
  5. Atualizar os plugins um a um é o que dá nome ao culpado
  6. O tema por último, e por que criar o tema-filho antes
  7. Três saídas para a tela branca, nesta ordem
  8. 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:

  1. Checar a versão de PHP do servidor e o PHP mínimo exigido pelos plugins e pelo tema.
  2. Fazer backup de arquivos e banco, e baixar o arquivo para a sua máquina.
  3. Atualizar o core do WordPress.
  4. Atualizar os plugins, um a um, testando o site entre cada um.
  5. 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.

Ordem de atualizacao em cinco passosChecar PHPVersao do servidor e minimosBackupArquivos, banco e downloadCoreAtualizar o WordPress primeiroPluginsUm a um, testando entre elesTemaPor ultimo, com tema-filho ativo
Do mais baixo para o mais alto: plataforma primeiro, depois o que depende dela.

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:

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:

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:

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:

  1. Backup de arquivos e banco, verificado.
  2. Desativar os plugins.
  3. Baixar o pacote do WordPress em wordpress.org e descompactar no seu computador.
  4. No servidor, apagar as pastas wp-admin e wp-includes antigas.
  5. Subir as pastas wp-admin e wp-includes novas.
  6. Copiar os arquivos que estão dentro da pasta wp-content do pacote novo por cima da sua wp-content existente, sobrescrevendo o que tiver o mesmo nome. Não apague a wp-content antiga e não apague nada dentro dela.
  7. Subir os arquivos soltos da raiz do pacote novo, sobrescrevendo os antigos. Não sobrescreva nem apague o wp-config.php.
  8. Abrir o painel. Se ele pedir atualização do banco de dados, confirmar.
  9. 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:

  1. Atualize um plugin.
  2. Abra o site em outra aba e recarregue a home e uma página que use aquele plugin (formulário, loja, galeria, cache).
  3. 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 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:

  1. No Gerenciador de Arquivos, entre em wp-content/plugins.
  2. Clique com o botão direito na pasta do plugin e escolha Compress para gerar um .zip dela.
  3. Baixe esse .zip para a sua máquina e só então volte ao painel e atualize.

Se a versão nova quebrar o site:

  1. 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.
  2. Envie o .zip que você baixou para dentro de wp-content/plugins e use Extract.
  3. Confirme que a pasta extraída tem o nome original do plugin, sem sufixo.
  4. No painel, o plugin aparece de novo na lista, na versão antiga. Ative.
  5. Apague a pasta -off quando 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:

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:

  1. Entre na pasta pública do site (costuma ser public_html) e depois em wp-content/plugins.
  2. Clique com o botão direito na pasta do plugin problemático e escolha Rename.
  3. Acrescente um sufixo ao nome, por exemplo nome-do-plugin-off.
  4. 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.

Tela branca: ordem das tentativasModo de RecuperacaoLink no e-mail de administracaodebug.logLigar log e ler arquivo culpadoRenomear pasta do pluginSufixo -off desativa sem painelRenomear pasta pluginsIsola se o problema e pluginTrocar tema pelo padraoSobrou tema ou core
Tente nesta ordem: cada passo so e necessario se o anterior nao resolveu.

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:

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:

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

  1. Documentação oficial do WordPress — Updating WordPress. Consultado em 2026-09-16.
Leia também