Wolfslender
Gamma
Programador
Usuário com poucas negociações! Use sempre o saldo do ForoBeta!
Recentemente chegou até mim um cliente com um problema muito comum: o site WordPress dele estava chegando ao limite de armazenamento da hospedagem, mas ele não sabia quais arquivos podia apagar sem quebrar nada.
Revisei a biblioteca de mídia e havia mais de 1,200 arquivos, muitos deles de temas anteriores, versões antigas de imagens e produtos descontinuados do WooCommerce.
O problema real não é encontrar os arquivos — é saber quais são seguros de excluir. Apagar o arquivo errado pode quebrar partes do site que você nem sabia que o usavam.
Neste tutorial eu mostro como fazer isso corretamente.
Você também pode baixá-lo diretamente em:
👉 wordpress.org/plugins/oliverodev-media-audit/
Você verá o dashboard principal com as estatísticas da sua biblioteca. Se for a primeira vez que você o abre, os contadores estarão zerados até você executar a primeira varredura.
O plugin faz a varredura em lotes para não estourar o tempo do servidor, mesmo em bibliotecas com milhares de arquivos. Você verá um contador em tempo real mostrando quantos arquivos já foram processados:
"Scanning 150 of 1,247 files · 1,097 remaining"
A varredura verifica:
Antes de apagar qualquer coisa, vá até a aba Unused Files.
Aqui você verá a lista de arquivos que a varredura não encontrou referenciados em nenhum lugar. Mas, antes de excluir, sempre recomendo revisar primeiro os arquivos marcados como "Used" para entender como a detecção funciona.
Clique no botão "Where?" ao lado de qualquer arquivo marcado como em uso. O plugin mostra exatamente onde ele está referenciado:
Antes de apagá-lo, aparece um modal de confirmação que mostra:
Ele gera um arquivo para download com:
A versão gratuita varre os locais padrão do WordPress. Se o seu site usa page builders ou ACF com campos de imagem, alguns arquivos podem não ser detectados corretamente, porque esses plugins guardam as referências em formatos proprietários. A versão PRO adiciona detecção específica para esses casos.
Dá para desfazer?
Não — a exclusão é permanente. Por isso existe o modal de confirmação. Se você precisa de uma rede de segurança, a versão PRO inclui um sistema de lixeira temporária para onde você pode mover arquivos antes de excluí-los definitivamente, com opção de restaurar.
Funciona em multisite?
A versão atual foi projetada para sites individuais. O suporte a multisite está em desenvolvimento.
Se você tiver perguntas sobre algum passo ou sobre como a detecção funciona internamente, respondo nos comentários.
Revisei a biblioteca de mídia e havia mais de 1,200 arquivos, muitos deles de temas anteriores, versões antigas de imagens e produtos descontinuados do WooCommerce.
O problema real não é encontrar os arquivos — é saber quais são seguros de excluir. Apagar o arquivo errado pode quebrar partes do site que você nem sabia que o usavam.
Neste tutorial eu mostro como fazer isso corretamente.
📌 O que você vai precisar
- WordPress 5.0 ou superior (funciona com WordPress 7.0 ✅)
- Acesso ao painel de administração
- O plugin OliveroDev Media Audit (grátis no WordPress.org)
Passo 1 — Instalar o plugin
Vá em Plugins → Adicionar novo e procure OliveroDev Media Audit. Instale e ative.Você também pode baixá-lo diretamente em:
👉 wordpress.org/plugins/oliverodev-media-audit/
Passo 2 — Abrir o plugin
Depois de ativado, vá em Ferramentas → OliveroDev Media Audit.Você verá o dashboard principal com as estatísticas da sua biblioteca. Se for a primeira vez que você o abre, os contadores estarão zerados até você executar a primeira varredura.
Passo 3 — Executar a varredura
Clique em Start New Scan.O plugin faz a varredura em lotes para não estourar o tempo do servidor, mesmo em bibliotecas com milhares de arquivos. Você verá um contador em tempo real mostrando quantos arquivos já foram processados:
"Scanning 150 of 1,247 files · 1,097 remaining"
A varredura verifica:
- Conteúdo de posts, páginas e tipos personalizados
- Post meta e dados serializados
- Configurações do tema (logo, cabeçalho, fundo)
- Widgets e tabela de opções
- Imagens destacadas
- Todos os tamanhos de imagem gerados pelo WordPress
Passo 4 — Revisar os resultados
Quando a varredura termina, o dashboard mostra quatro métricas:- Total files — quantos arquivos sua biblioteca tem
- In use — os que estão sendo referenciados em algum lugar do site
- Unused — os candidatos à exclusão
- Recoverable — o espaço total que você pode recuperar
Passo 5 — Verificar onde cada arquivo é usado (o mais importante)
Antes de apagar qualquer coisa, vá até a aba Unused Files.Aqui você verá a lista de arquivos que a varredura não encontrou referenciados em nenhum lugar. Mas, antes de excluir, sempre recomendo revisar primeiro os arquivos marcados como "Used" para entender como a detecção funciona.
Clique no botão "Where?" ao lado de qualquer arquivo marcado como em uso. O plugin mostra exatamente onde ele está referenciado:
- Em qual post ou página específica ele aparece
- Se é a imagem destacada de algum artigo
- Se está sendo usado como logo ou imagem de cabeçalho do tema
- Se está configurado como site icon
Passo 6 — Excluir arquivos não utilizados com segurança
Já na aba Unused Files, clique em Delete Permanently ao lado do arquivo que você quer excluir.Antes de apagá-lo, aparece um modal de confirmação que mostra:
- A miniatura do arquivo
- O nome completo
- O tamanho em disco
Passo 7 — Exportar o relatório (opcional, mas recomendado)
Se você está trabalhando no site de um cliente ou quer documentar quais arquivos excluiu, use o botão Export CSV na aba Unused Files.Ele gera um arquivo para download com:
- Nome do arquivo
- URL completa
- Tamanho em disco
- Tipo de arquivo (imagem, documento, vídeo etc.)
- Data de upload
Resultados
No caso do cliente que mencionei no início, depois da varredura e da limpeza:- Arquivos revisados: 1,247
- Arquivos realmente não utilizados: 634
- Espaço recuperado: 2.1 GB
- Tempo total do processo: ~15 minutos
Notas importantes
E o Elementor, o ACF ou o WooCommerce?A versão gratuita varre os locais padrão do WordPress. Se o seu site usa page builders ou ACF com campos de imagem, alguns arquivos podem não ser detectados corretamente, porque esses plugins guardam as referências em formatos proprietários. A versão PRO adiciona detecção específica para esses casos.
Dá para desfazer?
Não — a exclusão é permanente. Por isso existe o modal de confirmação. Se você precisa de uma rede de segurança, a versão PRO inclui um sistema de lixeira temporária para onde você pode mover arquivos antes de excluí-los definitivamente, com opção de restaurar.
Funciona em multisite?
A versão atual foi projetada para sites individuais. O suporte a multisite está em desenvolvimento.
Recursos
- 🔗 Plugin gratuito: wordpress.org/plugins/oliverodev-media-audit/
- 🚀 Versão PRO (trial de 3 dias sem cartão): checkout.freemius.com/plugin/23055/plan/47886/?trial=free
Se você tiver perguntas sobre algum passo ou sobre como a detecção funciona internamente, respondo nos comentários.