Guia de rollback do WordPress: como reverter atualização com segurança

17 min de leitura  ·  Guia técnico

Rollback do WordPress é a reversão do core, de um plugin ou de um tema para uma versão anterior quando uma atualização quebra o site. Para fazer rollback do WordPress com segurança, crie um backup completo, identifique o componente com falha, reinstale a versão estável anterior e teste o funcionamento antes de reativar tudo em produção.

1. Faça backup completo dos arquivos e do banco de dados.
2. Identifique se a falha veio do core, plugin ou tema.
3. Desative o componente problemático via painel, FTP ou SSH.
4. Instale a versão anterior pelo repositório oficial, FTP ou WP-CLI.
5. Teste o site, limpe o cache e monitore erros após a reversão.

Pré-requisitos para reverter atualização do WordPress com segurança

• Acesso ao painel administrativo do WordPress (wp-admin) ou acesso FTP/SFTP ao servidor.
• Credenciais de acesso ao cPanel ou SSH, caso o painel esteja inacessível.
• WP-CLI instalado no servidor (opcional, mas recomendado para rollback via linha de comando).
• Backup recente do banco de dados MySQL e dos arquivos do site.
• Conhecimento da versão anterior estável do componente que deseja reverter.
• Acesso ao repositório oficial do WordPress em wordpress.org para baixar versões antigas.

Por que o rollback do WordPress é necessário e quando usar

Reverter uma atualização do WordPress se torna necessário quando uma nova versão do core, de um plugin ou de um tema introduz incompatibilidades que quebram funcionalidades críticas do site. Os cenários mais comuns incluem: tela branca da morte (White Screen of Death), erro 500 após atualização, painel administrativo inacessível, conflito entre plugins e nova versão do PHP, e perda de funcionalidades de e-commerce ou formulários.

O processo de rollback de plugins e temas é relativamente simples e não afeta o banco de dados. Já o rollback do core do WordPress exige mais atenção, pois versões muito antigas podem ter vulnerabilidades de segurança conhecidas. Por isso, o objetivo do rollback deve ser sempre temporário: reverter para estabilizar o site enquanto aguarda uma versão corrigida do componente problemático.

Antes de iniciar qualquer reversão, verifique se o problema realmente foi causado pela atualização desativando plugins um a um. Muitas vezes, o conflito está em um único plugin e não no core do WordPress. Se você ainda não tem uma rotina de backups automáticos, considere configurar isso imediatamente em uma hospedagem que ofereça backups automáticos, cPanel e recuperação rápida de arquivos para reduzir o tempo de indisponibilidade.

Como fazer backup antes do rollback do WordPress

Nunca execute um rollback sem antes garantir que existe um backup funcional. Mesmo que o site esteja com problemas, é possível que a reversão piore a situação se feita sem cuidado. Existem três formas principais de fazer backup antes de reverter uma atualização.

Backup via cPanel (método mais rápido)

1. Acesse o cPanel do seu plano de hospedagem.
2. Vá em Backup ou Backup Wizard.
3. Clique em Baixar um backup completo do site e aguarde a geração do arquivo.
4. Faça o download do arquivo .tar.gz gerado para seu computador local.
5. Acesse também Bancos de Dados MySQL e exporte o banco do WordPress separadamente.

Backup via WP-CLI no servidor

Atenção: execute os comandos abaixo com o usuário correto do servidor. Substitua /home/usuario/public_html pelo caminho real da instalação do WordPress.

wp db export backup-antes-rollback.sql --path=/home/usuario/public_html
tar -czf backup-wp-files.tar.gz /home/usuario/public_html

Output esperado:
Success: Exported to 'backup-antes-rollback.sql'.
backup-wp-files.tar.gz criado com sucesso.

Backup via phpMyAdmin

1. Acesse o phpMyAdmin pelo cPanel.
2. Selecione o banco de dados do WordPress no painel esquerdo.
3. Clique em Exportar no menu superior.
4. Escolha o formato SQL e clique em Executar.
5. Salve o arquivo .sql gerado em local seguro.

Rollback de plugin do WordPress: passo a passo completo

A reversão de plugins é a operação de rollback mais frequente no WordPress. Quando um plugin atualizado causa conflito, você pode instalar a versão anterior diretamente do repositório oficial sem precisar de ferramentas externas.

Método 1: rollback manual via repositório wordpress.org

1. Acesse wordpress.org/plugins/[nome-do-plugin]/advanced no navegador (substitua pelo slug real do plugin).
2. Na seção Previous Versions, localize a versão anterior estável e clique em Download para baixar o arquivo .zip.
3. No painel do WordPress, vá em Plugins > Todos os plugins.
4. Desative o plugin problemático clicando em Desativar.
5. Após desativar, clique em Excluir para remover a versão com defeito.
6. Vá em Plugins > Adicionar novo > Enviar plugin.
7. Selecione o arquivo .zip baixado e clique em Instalar agora.
8. Ative o plugin e verifique se o site voltou ao funcionamento normal.

Método 2: rollback de plugin via WP-CLI

O WP-CLI permite reverter um plugin para uma versão específica com um único comando, sendo o método mais rápido para quem tem acesso SSH ao servidor.

wp plugin install nome-do-plugin --version=X.Y.Z --force --path=/home/usuario/public_html

Exemplo real revertendo o WooCommerce para a versão 8.5.2:

wp plugin install woocommerce --version=8.5.2 --force --path=/home/usuario/public_html

Output esperado:
Installing WooCommerce (8.5.2)
Downloading installation package from https://downloads.wordpress.org/plugin/woocommerce.8.5.2.zip...
Unpacking the package...
Installing the plugin...
Plugin updated successfully.

Método 3: rollback via FTP/SFTP

1. Conecte ao servidor via FTP usando o FileZilla como software FTP da sua hospedagem.
2. Navegue até o diretório /wp-content/plugins/.
3. Renomeie a pasta do plugin problemático (ex: woocommerce para woocommerce-backup) para desativá-lo sem excluir.
4. Faça upload da pasta do plugin na versão anterior (extraída do .zip baixado do repositório).
5. Acesse o painel do WordPress e ative o plugin reinstalado.

Rollback do core do WordPress para versão anterior

Reverter o core do WordPress exige mais cuidado do que reverter plugins, pois envolve substituir os arquivos centrais do sistema. Este procedimento é recomendado apenas quando o core atualizado causa erros críticos e não existe correção disponível.

Atenção: versões antigas do WordPress podem conter vulnerabilidades de segurança conhecidas. Use o rollback do core apenas como medida temporária e atualize para a versão corrigida assim que disponível.

Rollback do core via WP-CLI (recomendado)

wp core update --version=6.4.3 --force --path=/home/usuario/public_html

Output esperado:
Downloading WordPress 6.4.3 (pt_BR)...
Unpacking the update...
Cleaning up files...
No file was found in the trash.
Success: WordPress updated successfully.

Após o comando, verifique a versão instalada:

wp core version --path=/home/usuario/public_html

Output esperado:
6.4.3

Rollback do core via download manual

1. Acesse wordpress.org/download/releases e baixe o arquivo .zip da versão desejada.
2. Extraia o arquivo localmente. Você verá uma pasta chamada wordpress.
3. Conecte ao servidor via FTP/SFTP.
4. Faça upload de todos os arquivos da pasta extraída para o diretório raiz do WordPress, sobrescrevendo os existentes.
5. Não substitua as pastas wp-content e o arquivo wp-config.php — eles contêm seus dados e configurações.
6. Acesse o painel do WordPress. Se aparecer uma mensagem de atualização do banco de dados, clique em Atualizar banco de dados do WordPress.

Rollback de tema do WordPress sem perder personalizações

Reverter um tema funciona de forma similar ao rollback de plugins, mas exige atenção especial para não perder personalizações feitas via Customizer ou arquivos de template editados manualmente.

1. Antes de qualquer ação, exporte as configurações do tema via Aparência > Personalizar > Exportar/Importar (se o tema suportar).
2. Acesse o repositório do tema em wordpress.org/themes/[nome-do-tema]/advanced e baixe a versão anterior.
3. No painel, vá em Aparência > Temas e ative um tema padrão do WordPress (como o Twenty Twenty-Four) temporariamente.
4. Exclua o tema problemático.
5. Vá em Aparência > Temas > Adicionar novo > Enviar tema e faça upload do .zip da versão anterior.
6. Ative o tema reinstalado e reimporte as configurações exportadas anteriormente.

Para temas premium que não estão no repositório oficial, entre em contato com o desenvolvedor para obter o arquivo da versão anterior ou acesse a área de downloads da sua licença.

Como usar o plugin WP Rollback para reverter atualizações

O plugin WP Rollback simplifica o processo de reversão de plugins e temas diretamente pelo painel do WordPress, sem necessidade de acesso FTP ou linha de comando. É uma solução prática para administradores que preferem uma interface gráfica.

1. Acesse Plugins > Adicionar novo e busque por WP Rollback.
2. Instale e ative o plugin.
3. Vá em Plugins > Todos os plugins. Ao lado de cada plugin compatível, aparecerá um link Rollback.
4. Clique em Rollback no plugin que deseja reverter.
5. Selecione a versão anterior desejada na lista exibida.
6. Clique em Rollback e confirme a ação.
7. O plugin será substituído automaticamente pela versão selecionada.

O WP Rollback funciona apenas com plugins e temas hospedados no repositório oficial do WordPress. Para plugins premium de terceiros, use os métodos manuais descritos nas seções anteriores.

Troubleshooting: problemas comuns no rollback do WordPress e como resolver

Sintoma: painel do WordPress inacessível após atualização

Causa: um plugin ou o core atualizado causou um erro fatal de PHP, impedindo o carregamento do painel administrativo.
Solução: acesse o servidor via FTP ou cPanel File Manager e navegue até /wp-content/plugins/. Renomeie a pasta do plugin suspeito adicionando -disabled ao nome (ex: woocommerce-disabled). O WordPress desativará o plugin automaticamente. Se o problema for com todos os plugins, renomeie a pasta inteira plugins para plugins-disabled. Após recuperar o acesso ao painel, restaure a pasta e desative os plugins individualmente para identificar o culpado.

Sintoma: erro "The uploaded file exceeds the upload_max_filesize" ao instalar versão anterior

Causa: o arquivo .zip da versão anterior do plugin ou tema é maior do que o limite de upload configurado no PHP.
Solução: aumente temporariamente o limite de upload editando o arquivo php.ini ou .htaccess na raiz do WordPress. Adicione as linhas abaixo ao .htaccess:

php_value upload_max_filesize 64M
php_value post_max_size 64M

Alternativamente, instale o plugin via FTP fazendo upload direto da pasta extraída para /wp-content/plugins/, evitando o limite de upload do painel.

Sintoma: site continua com erro após rollback do plugin

Causa: o cache do WordPress ou de um plugin de cache está servindo a versão antiga com erro, ou há conflito com outro plugin.
Solução: limpe o cache do site imediatamente após o rollback. Se usar W3 Total Cache, WP Super Cache ou LiteSpeed Cache, acesse as configurações do plugin de cache e clique em Limpar todo o cache. Se o problema persistir, desative todos os plugins exceto o que foi revertido e reative-os um a um para identificar conflitos adicionais.

Sintoma: WP-CLI retorna "Error: WordPress files seem to already be at the specified version"

Causa: o WP-CLI detecta que a versão solicitada já está instalada ou há inconsistência nos arquivos de versão.
Solução: use a flag --force para forçar a reinstalação mesmo que a versão pareça idêntica:

wp core update --version=6.4.3 --force --path=/home/usuario/public_html

Se o erro persistir, verifique se o arquivo wp-includes/version.php contém a versão correta e se o usuário do servidor tem permissão de escrita nos diretórios do WordPress.

Sintoma: banco de dados incompatível após rollback do core

Causa: a versão mais nova do WordPress pode ter executado migrações no banco de dados que a versão anterior não reconhece.
Solução: se você fez backup do banco antes da atualização, restaure-o via phpMyAdmin ou WP-CLI. Caso contrário, o WordPress geralmente consegue operar com o banco na versão mais nova, mas algumas funcionalidades podem apresentar comportamento inesperado. Neste caso, a melhor abordagem é aguardar uma versão corrigida do componente problemático em vez de restaurar o banco. Para restaurar o banco via WP-CLI:

wp db import backup-antes-rollback.sql --path=/home/usuario/public_html

Output esperado:
Success: Imported from 'backup-antes-rollback.sql'.

Perguntas frequentes sobre rollback do WordPress

O que é rollback no WordPress e quando devo fazer?

Rollback no WordPress é o processo de reverter o core, um plugin ou tema para uma versão anterior após uma atualização causar erros, tela branca ou incompatibilidade. Você deve fazer rollback sempre que uma atualização quebrar funcionalidades críticas e não houver correção imediata disponível pelo desenvolvedor. O rollback deve ser tratado como medida temporária enquanto aguarda uma versão estável corrigida, pois versões antigas podem ter vulnerabilidades de segurança.

Como fazer rollback de um plugin do WordPress sem plugin adicional?

Acesse o repositório oficial em wordpress.org/plugins/[nome-do-plugin]/advanced, baixe o arquivo .zip da versão anterior e instale manualmente via Plugins > Adicionar novo > Enviar plugin no painel do WordPress. Antes de instalar, desative e exclua a versão atual com defeito. Este método funciona para qualquer plugin hospedado no repositório oficial do WordPress e não requer ferramentas externas além de acesso ao painel administrativo.

É possível fazer rollback do WordPress pelo WP-CLI?

Sim. Com o WP-CLI instalado no servidor, execute wp core update --version=6.4.3 --force para reverter o core para uma versão específica. Para plugins, use wp plugin install nome-do-plugin --version=X.Y.Z --force. O WP-CLI é o método mais rápido e confiável para rollback via linha de comando, especialmente quando o painel administrativo está inacessível. Certifique-se de especificar o caminho correto da instalação com o parâmetro --path.

Fazer rollback do WordPress apaga os dados do banco de dados?

Reverter apenas os arquivos do WordPress (core, plugins, temas) não apaga dados do banco de dados. Os arquivos do WordPress e o banco de dados são componentes separados: os arquivos ficam no servidor de hospedagem e o banco contém posts, páginas, usuários e configurações. Porém, se você restaurar um backup completo que inclua o banco, os dados inseridos após a data do backup serão perdidos. Sempre faça backup do banco antes de qualquer rollback para ter a opção de restauração caso necessário.

Como evitar que atualizações do WordPress quebrem o site no futuro?

Configure atualizações automáticas apenas para correções de segurança menores e teste atualizações maiores em um ambiente de staging antes de aplicar em produção. Mantenha backups automáticos diários do site e do banco de dados, e use um plugin de staging ou o recurso de backup do cPanel para facilitar reversões rápidas. Outra prática importante é manter um registro das versões de plugins e temas que funcionam bem juntos, facilitando o rollback para uma combinação estável conhecida quando necessário.

Conclusão

• Sempre faça backup antes de qualquer rollback — tanto dos arquivos quanto do banco de dados MySQL, usando cPanel, WP-CLI ou phpMyAdmin.
• Use o WP-CLI para rollbacks rápidos via linha de comando — os comandos wp core update --force e wp plugin install --version --force são os mais eficientes quando o painel está inacessível.
• Trate o rollback como medida temporária — mantenha o site na versão revertida apenas até que o desenvolvedor lance uma versão corrigida, e implemente um ambiente de staging para testar atualizações antes de aplicá-las em produção.

Leia também

• Solucionar erro 500 no WordPress: diagnóstico rápido e correção definitiva
• Migrar WordPress entre hospedagens sem downtime: procedimento completo
• Solucionar plugin causando lentidão no WordPress (e desativar cirurgicamente)

Precisa de ajuda com WordPress e hospedagem?

Manter o WordPress atualizado e estável exige uma infraestrutura de hospedagem confiável com backups automáticos e suporte técnico disponível. A AviraHost oferece planos de hospedagem otimizados para WordPress com backups diários, acesso ao cPanel e suporte especializado para situações como rollback e recuperação de site.

Conheça os planos de hospedagem WordPress da AviraHost