Como identificar e desativar um plugin que está causando tela branca (WSOD) no WordPress

Tela branca no WordPress (WSOD): como encontrar e desativar o plugin culpado

Oi! Aqui é a Sensei da GeHost 🥋 e hoje vamos resolver um dos maiores sustos de quem usa WordPress: você entra no site e... nada. Só uma tela branca, sem nenhuma mensagem. Isso é conhecido como WSOD (White Screen of Death), e na grande maioria das vezes o culpado é um plugin que travou depois de uma atualização ou incompatibilidade.

Respira fundo: isso não significa que seu site foi hackeado ou perdeu dados. É só um "engasgo" de código, e vamos resolver juntos, passo a passo, direto pelo cPanel.

Dica da Sensei: antes de mexer em qualquer arquivo, se você tiver um backup recente disponível no seu painel, é sempre bom saber que ele existe como rede de segurança. Confira em Backup no cPanel.

Passo 1 — Acesse o cPanel

Primeiro, entre no cPanel da sua hospedagem com seu usuário e senha.

Depois de logar, você verá o painel inicial com vários grupos de ferramentas (E-mail, Arquivos, Bancos de Dados etc.). É por aqui que vamos trabalhar.

Passo 2 — Abra o Gerenciador de Arquivos

Na seção Arquivos, clique em Gerenciador de Arquivos (File Manager). É a ferramenta que vamos usar para "desligar" plugins sem precisar entrar no painel do WordPress — afinal, se o site está com tela branca, o painel admin também pode estar inacessível.

2.1 — Chegue até a pasta de plugins

Navegue até:

1. public_html (ou a subpasta onde seu WordPress está instalado, caso não seja na raiz)
2. wp-content
3. plugins

Passo 3 — Teste desativando TODOS os plugins de uma vez

Essa é a forma mais rápida de confirmar se o problema é mesmo um plugin:

1. Clique com o botão direito na pasta plugins e escolha Renomear.
2. Mude o nome para algo como plugins_old e confirme.
3. Abra seu site em outra aba do navegador e veja se a tela branca sumiu.

Ao renomear essa pasta, o WordPress simplesmente não encontra mais nenhum plugin para carregar — é como se todos fossem desativados de uma vez, sem apagar nada. Se o site voltar ao normal, confirmamos: o problema é um plugin.

Dica da Sensei: se o site continuar branco mesmo com a pasta renomeada, o problema provavelmente não é plugin — pode ser tema ou outra causa. Nesse caso, é melhor chamar o suporte pra investigar com calma.

Passo 4 — Descubra QUAL plugin é o culpado

Agora vem a parte de detetive 🔍. Vamos voltar tudo ao normal e testar plugin por plugin:

1. Renomeie a pasta plugins_old de volta para plugins.
2. Entre na pasta plugins. Você verá uma subpasta para cada plugin instalado (o nome da pasta geralmente é bem parecido com o nome do plugin).
3. Renomeie uma pasta de plugin por vez (por exemplo, adicionando "_old" no final) e recarregue o site a cada tentativa.
4. Quando o site voltar a funcionar logo após renomear uma pasta específica, é ele! Esse é o plugin que estava causando a tela branca.

Dica da Sensei: vá com calma e teste um de cada vez — se renomear vários juntos, você desativa o problema, mas não descobre quem foi o culpado.

Passo 5 — O que fazer depois de encontrar o culpado

• Se conseguir acessar o painel do WordPress normalmente, entre em Plugins, exclua o plugin problemático (a pasta renomeada aparecerá como "inativo/quebrado" na lista) e reinstale a versão mais recente.
• Se preferir manter esse plugin desativado por enquanto, é só deixar a pasta dele com o nome alterado (ex.: nome-do-plugin_old) — o WordPress simplesmente ignora essa pasta.
• Renomeie de volta ao nome original as pastas dos outros plugins que você testou e que não eram os culpados, para que voltem a funcionar normalmente.

Prevenindo o WSOD no futuro

• Sempre atualize plugins e temas um de cada vez, não todos juntos — assim fica fácil saber quem causou algum problema.
• Evite instalar plugins de fontes desconhecidas ou sem atualização há muito tempo.
• Tenha por hábito conferir a sua rotina de backups no painel antes de fazer grandes atualizações.

Ainda com tela branca? Se depois de testar tudo isso o problema continuar, não se preocupe — nossa equipe de suporte está pronta para te ajudar. Abra um chamado com os detalhes do que você já tentou, assim conseguimos agilizar a análise. 💛

Viu só? Um susto grande, mas uma solução simples. Você acabou de aprender uma técnica que até muitos desenvolvedores usam no dia a dia. Até a próxima! 🥋