O erro de upload de mídia quase sempre vem de limite de PHP, permissão de pasta ou biblioteca de imagem. Segundo a documentação do WordPress (2026), o upload_max_filesize padrão é 2 MB. Subir esse valor para 64 MB resolve a maioria dos casos. Comece pelo diagnóstico, não pelo plugin.

O erro de upload de mídia é qualquer falha que impede o WordPress de salvar uma imagem, vídeo ou PDF na biblioteca de mídia. Ele aparece como “HTTP error”, mensagem de tamanho excedido ou uma barra de progresso que trava em 0%. A causa raiz raramente é o arquivo: é a configuração de PHP, a permissão da pasta /wp-content/uploads/ ou a biblioteca GD Library do servidor. Antes de instalar qualquer plugin, vale isolar o sintoma. Este guia integra o hub de erros comuns do WordPress da FULL e segue a mesma lógica de diagnóstico que a gente usa no suporte: do mais provável ao mais raro.

Diagnóstico rápido: Sintoma, causa e correção do erro de upload de mídia

Na maioria dos chamados de upload no suporte da FULL, o sintoma já entrega a causa do erro de upload de mídia. Um “HTTP error” genérico aponta para memória ou biblioteca de imagem; “excede o tamanho máximo” é limite de PHP; uma barra travada em 0% costuma ser permissão de pasta. A tabela cruza cada sintoma com a causa provável e a primeira ação.

Legenda: o “HTTP error” genérico é o sintoma mais comum e o que menos diz sobre a causa real.

Limite de PHP: A causa nº 1 do erro de upload de mídia

A causa mais frequente do erro de upload de mídia é o limite de PHP travado no padrão de 2 MB do upload_max_filesize, abaixo do peso de muitas fotos de celular (4 a 12 MB). Outros dois parâmetros entram junto: post_max_size (mínimo de 64 MB) e memory_limit (256 MB). Curto qualquer um, o WordPress recusa o arquivo antes de processá-lo.

A forma mais limpa de subir esses valores é pelo php.ini, quando a hospedagem dá acesso. Sem acesso, tente o .htaccess na raiz com php_value upload_max_filesize 64M. Em PHP como CGI, esse método falha em silêncio, e o caminho passa a ser o functions.php do tema com a função upload_size_limit. Vale conferir o valor efetivo em Ferramentas > Saúde do site, que mostra o limite real aplicado pelo servidor, e não o que você editou. O guia de como fazer upload de imagens grandes no WordPress cobre cada cenário.

HTTP error: Quando o servidor não consegue processar a imagem

O “HTTP error” é o rosto mais confuso do erro de upload de mídia porque não diz nada sobre a causa. Na maioria dos casos, a memória de PHP estourou ao processar a imagem, ou falta a biblioteca GD Library e o Imagick no servidor. O WordPress gera miniaturas em cada upload, e uma foto de 6.000 px sem memória derruba o processo no meio.

A primeira ação é elevar o memory_limit para 256M no wp-config.php com define('WP_MEMORY_LIMIT', '256M');. Persistindo, o problema está na biblioteca de imagem do servidor: é caso de abrir chamado com a hospedagem para ativar o Imagick. A gente vê no suporte que limpar o cache do CDN também resolve uma fatia, porque o “HTTP error” às vezes é timeout de rede disfarçado. O guia de problemas comuns de imagem no WordPress detalha os subcasos.

Permissões de pasta: O erro de upload de mídia silencioso

Quando a barra de upload trava em 0% sem mensagem, a causa do erro de upload de mídia costuma ser permissão errada na pasta /wp-content/uploads/. O WordPress precisa de escrita nesse diretório; se a pasta estiver em 644 em vez de 755, o upload é recusado sem aviso ao administrador. É o tipo de falha que parece bug do plugin, mas é infraestrutura.

A correção é aplicar 755 nas pastas e 644 nos arquivos, via FTP como Filezilla ou pelo gerenciador da hospedagem. O guia de corrigir erros de permissões de arquivos e pastas no WordPress traz os comandos. Um detalhe pouco coberto: em Apache com mod_security ativo, regras de WAF mal calibradas bloqueiam o POST antes de chegar ao WordPress, simulando falha de permissão. Aí a pasta media-library está correta, e o bloqueio vem do servidor.

Outras causas do erro de upload de mídia e quando suspeitar de plugin

Resolvido o trio PHP, HTTP error e permissões, sobram causas de cauda longa, uma minoria dos chamados de erro de upload de mídia. Conflito de plugin é a mais citada e a menos comum: desative todos, teste o upload e reative um a um. Cache agressivo de plugins como WP Rocket pode servir uma versão antiga da biblioteca, dando impressão de que o arquivo não subiu. Limpar o cache resolve.

Outras três causas valem checagem. Caminho de uploads incorreto no banco faz a imagem sumir após salva: confira em Configurações > Mídia. Um tema que carrega o functions.php com erro de sintaxe derruba o processador. E o bloqueio por extensão, comum com SVG e WebP, exige liberar o tipo MIME. O artigo dos 50 erros mais comuns do WordPress mapeia cada um. Se só aparece no Gutenberg, cruze com o erro “não é um JSON válido” no WordPress, de sintoma parecido.

Resolva o upload e o resto do site com a plataforma FULL

Corrigir o erro de upload de mídia uma vez é simples; manter PHP, permissões e bibliotecas de imagem afinados em vários sites é o que cansa. A plataforma FULL conecta e gerencia mais de 150 mil sites WordPress a partir de um painel só, com os 17 plugins do bundle (incluindo WP Rocket e Perfmatters) já ativados em um clique. O plano PRO sai por R$849,90 e cobre até 10 sites, o que dá R$85 por site, contra o avulso de cada plugin separado. Para quem administra carteira de clientes, ver os planos da FULL costuma fechar a conta antes do primeiro chamado de suporte.

Perguntas frequentes sobre o erro de upload de mídia

Próximos passos para destravar o upload de mídia

O erro de upload de mídia tem um número pequeno de causas reais, e quase todas se resolvem em minutos quando você ataca na ordem certa: primeiro o limite de PHP, depois o HTTP error por memória, depois a permissão da pasta de uploads e só então o conflito de plugin. Pular para o plugin antes de checar a configuração do servidor é o que mais alonga o problema. Para continuar aprendendo a diagnosticar falhas do WordPress, o guia de corrigindo erros comuns do WordPress reúne os casos em sequência, e o FULL Academy organiza tutoriais, guias e reviews em um só lugar.