Atualizar manualmente plugins WordPress significa substituir a pasta do plugin direto no servidor, via FTP ou gerenciador de arquivos, em vez de clicar em “Atualizar agora” no painel. É o procedimento que resolve quando o update automático falha por timeout do PHP, por licença premium bloqueada ou por um erro fatal que derruba o site. Este tutorial mostra o caminho seguro: backup, conexão FTP, desativação, troca da pasta e teste. Se você prefere o fluxo simples pelo wp-admin, veja antes como atualizar corretamente os plugins do WordPress e os melhores plugins para WordPress no centro de aprendizado da FULL.

Quando atualizar manualmente plugins WordPress faz sentido

Atualizar manualmente plugins WordPress faz sentido em três cenários em que o botão “Atualizar agora” do painel não conclui o processo: timeout do PHP em arquivos grandes, licença premium com servidor de validação indisponível e erro fatal que derruba o wp-admin. Nesses casos, trocar a pasta do plugin direto no servidor é a saída de cerca de 10 minutos.

O painel é conveniente, mas depende de o WordPress conseguir baixar, descompactar e gravar arquivos sozinho. A tabela abaixo resume qual método usar em cada situação, com o sintoma típico que aparece nos tickets de suporte da FULL.

Por que o painel WordPress falha ao atualizar um plugin

O update pelo painel falha porque o WordPress precisa baixar o pacote, descompactar e gravar a nova pasta dentro de um único ciclo de execução do PHP, limitado por padrão a 30 segundos. Plugins como Elementor PRO ou WooCommerce, com dezenas de megabytes, estouram esse limite em hospedagens compartilhadas. Quando o PHP encerra no meio, a pasta antiga fica meio sobrescrita.

Esse update interrompido pela timeout do PHP gera a temida tela branca da morte (WSOD), sem mensagem de erro visível, e é onde atualizar manualmente plugins WordPress entra como saída. O WordPress ainda deixa um arquivo .maintenance na raiz. Outro motivo comum é o plugin premium: com o servidor de licença fora do ar, o botão de atualizar fica inerte mesmo com a versão nova disponível. Antes de mexer, vale checar o plugin de segurança WordPress que você usa, já que um deles fora do ar abre brecha.

O que fazer antes: Backup obrigatório

Atualizar manualmente plugins WordPress nunca começa sem backup: trocar a pasta de um plugin no servidor é destrutivo, o arquivo antigo some no instante em que o novo entra. Um backup completo de arquivos e banco leva de 2 a 5 minutos com UpdraftPlus e é a única rede de segurança real se a versão nova quebrar o site.

Restaurar custa um clique; reconstruir do zero custa horas.

O ideal é manter um backup do WordPress automático rodando, mas para uma troca pontual o backup manual antes do procedimento já basta. Guarde o pacote fora do servidor: baixe o .zip para o seu computador ou para um drive na nuvem. Se algo der errado, o caminho de volta é restaurar o WordPress a partir do backup. Para entender quais arquivos importam, a FULL detalha quais arquivos do WordPress você deve fazer backup e o jeito certo de gerar o pacote completo.

Passo a passo: Atualizar manualmente plugins WordPress via FTP

Atualizar manualmente plugins WordPress segue cinco passos curtos: baixar a versão nova, conectar ao servidor, desativar o plugin, trocar a pasta e reativar testando. O procedimento completo leva cerca de 10 minutos por plugin e não exige nenhum conhecimento de código. Você vai precisar de um cliente FTP como o Filezilla e dos dados de acesso (host, usuário, senha e porta) que a sua hospedagem fornece no painel.

Legenda: a pasta wp-content/plugins é o único diretório que você precisa tocar para trocar a versão de um plugin.

Passo 1: Baixe o arquivo .zip da versão nova

Baixe o pacote oficial da versão nova antes de tocar no servidor, sempre da fonte legítima do plugin. Plugins gratuitos vêm do diretório oficial em WordPress.org Plugins, na aba “Development” da página do plugin, que lista todas as versões. Plugins premium ficam na conta do desenvolvedor (Elementor, Crocoblock) ou no painel da FULL, quando o plugin faz parte do bundle. Confira a versão no nome do arquivo para não baixar a errada.

Passo 2: Conecte ao servidor pelo Filezilla

Conecte ao servidor usando os dados de FTP ou SFTP que a hospedagem fornece. Abra o Filezilla, preencha host, usuário, senha e porta (21 para FTP, 22 para SFTP) e clique em “Conexão rápida”. Prefira SFTP sempre que possível: o canal é criptografado e protege as credenciais em trânsito. No painel direito, navegue até a raiz do WordPress, onde ficam as pastas wp-admin, wp-includes e wp-content.

Passo 3: Desative o plugin antes da troca

Desative o plugin no painel WordPress antes de trocar a pasta, pela tela Plugins do wp-admin. Esse passo evita que o WordPress tente executar metade do código antigo e metade do novo durante a substituição. Se o painel estiver fora do ar por causa de um erro fatal, renomeie a pasta do plugin via FTP (de meu-plugin para meu-plugin-off): isso força o WordPress a desativá-lo e devolve o acesso ao wp-admin na maioria dos casos.

Passo 4: Apague a pasta antiga e suba a nova

Descompacte o .zip no seu computador, apague a pasta antiga do plugin no servidor e suba a nova no lugar. Dentro de wp-content/plugins, exclua a pasta com o nome do plugin (por exemplo, elementor) e arraste a pasta descompactada da versão nova para o mesmo local. Atualizar por cima, sem apagar a antiga, deixa arquivos órfãos de versões anteriores que causam conflitos silenciosos. A pasta nova tem que substituir a antiga por completo.

Passo 5: Reative e teste o site

Reative o plugin no painel e percorra o site para confirmar que tudo funciona. Volte à tela Plugins, clique em “Ativar” e abra o front-end mais a área administrativa. Teste a função que o plugin controla: um formulário do WPForms, um popup do Elementor, o checkout do WooCommerce. Se a versão antiga continuar aparecendo, limpe o cache, porque um cache de object ativo serve o conteúdo antigo da memória mesmo com a pasta nova já no servidor.

Como destravar o site quando o update já quebrou tudo

Atualizar manualmente plugins WordPress também destrava o site depois que o update via painel morre por timeout e deixa tudo em tela branca: a recuperação leva menos de 5 minutos pela FTP, sem restaurar backup. O WordPress costuma deixar dois rastros na raiz, um arquivo .maintenance e uma pasta upgrade/ cheia.

Apagar o .maintenance via FTP tira o site do modo de manutenção na hora. Depois, vá até a pasta wp-content/plugins e finalize a substituição da pasta do plugin que estava sendo atualizado, seguindo os passos do procedimento. Se o site não voltar, o problema pode ser incompatibilidade com a versão do PHP do WordPress ou conflito entre plugins: desative todos renomeando a pasta plugins para plugins-off e reative um a um para achar o culpado. Em manutenção programada, considere colocar o WordPress em modo manutenção de propósito antes de mexer, para que visitantes não vejam telas de erro.

Atualizar plugins Premium e em escala com a FULL

Atualizar manualmente plugins WordPress resolve o caso pontual, mas repetir isso para plugins premium em dezenas de sites consome horas que poderiam virar trabalho faturável. O plano PRO da FULL custa R$849,90 e inclui 17 plugins premium com ativação em 1 clique, sem gerenciar licença, download ou troca de pasta em cada site.

Distribuído pelos sites que uma agência opera, isso sai por volta de R$85 por site, e troca o FTP manual por um botão no painel. A gente vê no suporte da FULL que boa parte dos chamados de “plugin não atualiza” vem de licença premium expirada ou servidor de validação fora do ar; com o bundle, a FULL administra a licença dos 17 plugins e o update chega validado. Para escalar, conheça os planos da FULL, ou veja como limpar o cache no WordPress e como instalar um plugin WordPress passo a passo.

Perguntas frequentes sobre atualizar plugins WordPress manualmente

Próximos passos para manter seus plugins em dia

Atualizar manualmente plugins WordPress deixa de ser emergência quando vira parte de uma rotina com backup e teste. O fluxo seguro para atualizar manualmente plugins WordPress é sempre o mesmo: backup completo, download da versão certa, desativação, troca da pasta via FTP e teste no front-end. Guarde o cliente Filezilla configurado e os dados de acesso à mão para resolver qualquer update travado em minutos, sem depender do painel. Para continuar aprendendo WordPress, o FULL Academy reúne tutoriais, guias e reviews em um só lugar, do gerenciamento de plugins à performance do site.