# 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.

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

João Rizzon · 2026-10-08 · WordPress

---

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](https://wordpress.org/documentation/article/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-tema` e procure, na coluna de detalhes, as linhas de versão mínima do WordPress e de PHP. O campo no `style.css` do tema se chama `Requires 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 o `wp-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.org` e descompactar no seu computador.
- No servidor, apagar as pastas `wp-admin` e `wp-includes` antigas.
- Subir as pastas `wp-admin` e `wp-includes` novas.
- 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.
- 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 `.zip` dela.
- 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:

- 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 `.zip` que você baixou para dentro de `wp-content/plugins` e 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 `-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:

- 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:

```php
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 em `wp-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.

