Imagens não aparecem no WordPress: causas e soluções
Do ícone de imagem quebrada à miniatura em branco: como testar o endereço do arquivo, ler a aba Network, usar a Saúde do site e refazer miniaturas.
Por Redação Eleven Host · @robson.direitodigital · 22 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: Imagens não aparecem no WordPress: causas e soluções Arte: Eleven Host
Quando as imagens não aparecem no WordPress, o sintoma diz onde procurar: ícone de imagem quebrada no site, miniatura em branco na Biblioteca de Mídia, erro ao enviar o arquivo ou foto que só surge depois de rolar a página. Cada caso tem uma causa provável e um teste.
Um teste simples é abrir o endereço da imagem numa aba nova. Se o arquivo abre, o problema provável está na página, no tema ou no cache; se dá erro 404 ou 403, está no arquivo, na pasta ou no endereço gravado.
Primeiro teste: abrir o endereço da imagem
Pela documentação do WordPress, a Biblioteca de Mídia mostra as imagens em grade ou em lista. Na grade, clicar numa miniatura abre os detalhes do anexo, com nome do arquivo, tipo, tamanho, dimensões e o endereço do arquivo, além de um botão para copiar esse endereço. Os nomes das telas em português podem variar com a versão e o idioma do painel.
Abra o endereço copiado numa aba nova.
Na página onde a imagem falha, o navegador também ajuda. A documentação do Chrome DevTools indica abrir as ferramentas com Control+Shift+J (Windows e Linux) ou Command+Option+J (Mac), clicar na aba Network e recarregar a página, porque o registro só acontece com elas abertas. A coluna Status traz o código de resposta de cada arquivo.
Pela referência do MDN, o 404 indica que o servidor não encontrou o recurso pedido, e o 403 indica que o servidor entendeu o pedido e se recusa a atender, sem mudar se você repetir. Quando a imagem não pode ser exibida, por erro de rede, link quebrado ou formato não suportado, o MDN diz que o navegador pode mostrar o texto alternativo.
O que aparece e a causa provável
Cada sintoma abaixo tem uma causa provável; confirme com o teste do endereço antes de mexer no site.
- Imagem quebrada logo depois de ligar o HTTPS: arquivos ainda chamados por http://, o conteúdo misto.
- Imagens quebradas depois de trocar o domínio ou o endereço: o conteúdo continua apontando para o endereço antigo.
- Miniaturas em branco na Biblioteca ou tamanhos faltando: biblioteca de imagem do servidor ou miniaturas que não foram geradas.
- Erro HTTP ou falha ao enviar: arquivo acima do limite, formato que o servidor não aceita ou pasta sem permissão de escrita.
- Imagem antiga que continua no lugar da nova: cache de página, do navegador ou de CDN.
- Imagem que só aparece depois de rolar, ou nunca: carregamento adiado (lazy load) de plugin, tema ou serviço externo.
Uma coluna para cada imagem conferida
Recomendamos anotar o nome do arquivo, o endereço copiado e o código visto na aba Network de cada imagem testada.
Marca nova, site novo: o domínio pode ser registrado na Eleven Host. Buscar domínio
Imagem quebrada depois de ligar o HTTPS
Se as imagens sumiram logo depois de o site passar a abrir em https://, olhe na aba Network se algum arquivo ainda é pedido por http://. Esse é o conteúdo misto: a página chega por conexão segura, mas parte dos arquivos vem por conexão insegura. O que é o conteúdo misto e como corrigir no site estão em Conteúdo misto: o que é e como corrigir no site.
Imagens somem depois de trocar o domínio
Quando o endereço do site muda, os posts antigos podem continuar apontando para o domínio anterior. Na aba Network, o sinal é imagem pedida ao endereço velho. O passo a passo para trocar o endereço do site no WordPress está em Mudar URL do WordPress: como trocar o endereço do site.
Miniaturas em branco ou tamanhos faltando
A tela Configurações > Mídia define os tamanhos miniatura, médio e grande, e a documentação dessa tela avisa que o recurso precisa da biblioteca GD do PHP no servidor.
Para saber qual biblioteca o site usa, abra Ferramentas > Saúde do site e vá à aba Informação. Pela documentação, a seção de mídia mostra o editor ativo (o padrão usa a GD; outro nome indica a Imagick), a versão da GD e os formatos aceitos.
Se a biblioteca está presente e as miniaturas continuam faltando, o WP-CLI, a linha de comando do WordPress (se estiver instalado no servidor), tem o comando que refaz as miniaturas. Pela documentação, a opção --only-missing gera só os tamanhos que faltam, e a confirmação aparece quando nenhum ID de anexo é informado; --yes responde sim a ela. Dentro da pasta do WordPress e com o usuário dono dos arquivos, um exemplo de comando, juntando as duas opções documentadas:
wp media regenerate --only-missing --yes
Para refazer só algumas imagens, a documentação mostra IDs de anexo no lugar das opções:
wp media regenerate 123 124 125
Troque os números pelos IDs das suas imagens e confira no seu servidor antes de rodar. Recomendamos testar com um ID primeiro. A documentação lembra que, sem a opção --skip-delete, as miniaturas antigas são apagadas, e aconselha mantê-las se estiverem linkadas em lugares que você não controla.
Erro HTTP ou falha ao enviar a imagem
Primeiro, confira o tamanho. Pela documentação, a tela Mídia > Adicionar nova mostra embaixo o tamanho máximo de envio definido pela hospedagem. Na Saúde do site, a seção de mídia traz o máximo de um arquivo enviado, o máximo de dados por envio e o máximo efetivo, que é o menor dos dois; ali também aparece se o envio de arquivos está ligado. Se estiver desligado, a documentação manda falar com a hospedagem.
Se o arquivo passa do limite, uma saída é reduzir a imagem antes de enviar; outra é subir o limite no servidor, passo a passo descrito no artigo Aumentar limite de upload do WordPress: passo a passo, na base de conhecimento.
Se o arrastar e soltar falha, a mesma tela oferece o envio pelo navegador como segundo caminho.
WebP e AVIF que não sobem
Pela nota de desenvolvimento de junho de 2021, o WordPress 5.8 passou a aceitar WebP como JPEG ou PNG, desde que a biblioteca de imagem do servidor (Imagick ou GD) aceite o formato; sem isso, o envio de WebP dá mensagem de erro. A nota de fevereiro de 2024 diz que o WordPress 6.5 aceita AVIF nas mesmas condições, com a biblioteca do servidor compatível, e indica onde conferir: Ferramentas > Saúde do site, aba Informação, seção de mídia, procurando AVIF na lista de formatos.
Se muitos visitantes usam navegador sem AVIF, a mesma nota recomenda evitar o formato ou carregar um polyfill. O formato WebP e o uso no HTML estão em Imagem WebP: o que é e como usar no site.
Permissões da pasta uploads
Pela documentação de Configurações > Mídia, desde a versão 3.5 o caminho padrão dos envios é wp-content/uploads, e o WordPress cria as pastas de ano e mês na hora do envio, desde que a pasta wp-content permita escrita. Na Saúde do site, a seção de permissões do sistema de arquivos mostra se o WordPress consegue gravar na pasta principal, em wp-content, em uploads, em plugins e em temas.
A página de permissões do WordPress diz que o site pode precisar de escrita em wp-content e, em alguns casos, em wp-content/uploads. O esquema geral da página é 755 para pastas e 644 para arquivos (750 e 640 com suexec), e ela avisa que permissão baixa demais pode impedir o servidor de ler ou gravar. A mesma página desaconselha o 777, que deixa os arquivos graváveis por qualquer processo do servidor. Recomendamos anotar o valor atual antes de mudar.
Cache, CDN e carregamento adiado
Se a imagem nova não aparece e a antiga continua no lugar, a causa provável é uma cópia guardada no caminho: cache de página, do navegador ou de uma CDN. Pela documentação do Chrome DevTools, segurar o botão de recarregar com as ferramentas abertas dá a opção de esvaziar o cache e recarregar. Como limpar o cache do plugin depois de mudar o site está em Plugin de cache WordPress: como escolher e configurar.
Desde o WordPress 5.5, segundo a nota de julho de 2020, o próprio WordPress acrescenta o atributo loading="lazy" nas imagens que têm largura e altura, e navegadores sem suporte ignoram o atributo. O MDN explica que esse atributo adia o carregamento até a imagem chegar perto da área visível, só com JavaScript ligado, e que uma imagem adiada sem largura e altura pode nunca carregar. Se a imagem some só com um plugin de otimização ou script extra de lazy load, teste desligar o recurso e limpar o cache.
Checklist quando as imagens não aparecem
- abrir o endereço da imagem numa aba nova;
- ver o código na aba Network (404, 403 ou http://);
- conferir se houve troca para HTTPS ou de domínio;
- olhar editor e formatos na Saúde do site;
- refazer só as miniaturas que faltam;
- comparar o arquivo com o tamanho máximo de envio;
- checar a escrita em wp-content/uploads, sem 777;
- limpar cache e testar sem o lazy load extra.
Um índice das correções por data
Recomendamos guardar a data e o que mudou em cada correção, para poder desfazer.
Máquinas virtuais privadas, as VPS, podem ser contratadas na Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Perguntas frequentes
Por que a imagem aparece na Biblioteca de Mídia, mas não no site?
Se o arquivo abre pelo endereço copiado nos detalhes do anexo, a causa provável está na página: endereço antigo no post, conteúdo misto, cache ou lazy load. A aba Network mostra qual pedido falhou.
O que acontece com as miniaturas antigas ao regenerar?
O comando refaz as miniaturas. A documentação avisa que, sem --skip-delete, as miniaturas antigas são apagadas, por isso vale usar essa opção se elas estiverem linkadas fora do site.
Posso usar 777 na pasta uploads para resolver o envio?
A página de permissões do WordPress desaconselha o 777. Confira na Saúde do site se a pasta aceita escrita e ajuste a permissão seguindo os valores da documentação.
Como saber se o servidor aceita WebP e AVIF?
Em Ferramentas > Saúde do site, aba Informação, a seção de mídia lista os formatos aceitos pela biblioteca de imagem.