# Erro de upload de mídia no WordPress: 5 causas e correção

O <strong>erro de upload de mídia</strong> quase sempre vem de limite de PHP, permissão de pasta ou biblioteca de imagem. Segundo a <a href="https://developer.wordpress.org/advanced-administration/server/php/" rel="noopener" target="_blank">documentação do WordPress (2026)</a>, 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 <a href="https://full.services/erros-wordpress/">erros comuns do WordPress da FULL</a> 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.

<p class="wp-caption-text">Legenda: o "HTTP error" genérico é o sintoma mais comum e o que menos diz sobre a causa real.</p>

<table id="diagnostico-erro-upload-midia">
  <caption>Erro de upload de mídia: sintomas, causas e correções</caption>
  <thead>
    <tr>
      <th scope="col">Sintoma</th>
      <th scope="col">Causa raiz provável</th>
      <th scope="col">Ação corretiva</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">"HTTP error" genérico</th>
      <td>Memória PHP baixa ou GD Library/Imagick ausente</td>
      <td>Subir memory_limit para 256M e verificar a biblioteca de imagem</td>
    </tr>
    <tr>
      <th scope="row">"Excede o tamanho máximo"</th>
      <td>upload_max_filesize travado em 2 MB</td>
      <td>Editar php.ini ou .htaccess para 64 MB</td>
    </tr>
    <tr>
      <th scope="row">Barra trava em 0%</th>
      <td>Permissão errada em /uploads/ ou mod_security</td>
      <td>Aplicar 755 nas pastas e revisar regras do servidor</td>
    </tr>
    <tr>
      <th scope="row">Imagem some após salvar</th>
      <td>Caminho de uploads incorreto no banco</td>
      <td>Conferir o diretório de mídia em Configurações</td>
    </tr>
  </tbody>
</table>

---

## 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 <a href="https://full.services/glossario/htaccess/">.htaccess</a> 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 <a href="https://full.services/como-fazer-upload-de-imagens-grandes-no-wordpress/">como fazer upload de imagens grandes no WordPress</a> 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 <a href="https://full.services/glossario/wp-config/">wp-config.php</a> 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 <a href="https://full.services/como-corrigir-problemas-comuns-de-imagem-wordpress/">problemas comuns de imagem no WordPress</a> 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 <a href="https://full.services/corrigir-erro-permissoes-arquivos-e-pastas-wordpress/">corrigir erros de permissões de arquivos e pastas no WordPress</a> 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 <a href="https://full.services/glossario/media-library/">media-library</a> 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 <a href="https://full.services/glossario/functions-php/">functions.php</a> 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 <a href="https://full.services/50-erros-mais-comuns-do-wordpress-e-como-corrigi-los/">50 erros mais comuns do WordPress</a> mapeia cada um. Se só aparece no Gutenberg, cruze com o <a href="https://full.services/erro-nao-e-um-json-valido-wordpress/">erro "não é um JSON válido" no WordPress</a>, 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 <a href="https://full.services/planos">planos da FULL</a> costuma fechar a conta antes do primeiro chamado de suporte.

<aside aria-label="Metodologia dos Testes">
<h2 id="metodologia-dos-testes">Metodologia dos testes</h2>
<p>Este diagnóstico foi montado a partir do padrão de chamados de upload que chegam ao suporte da FULL, cruzado com a documentação oficial do PHP e do WordPress. Os valores de referência (upload_max_filesize de 2 MB padrão, 64 MB recomendado, memory_limit de 256 MB) foram conferidos contra o WordPress 6.x e PHP 8.x entre <time datetime="2026-01">janeiro</time> e <time datetime="2026-05">maio de 2026</time>, nos ambientes Apache e LiteSpeed mais comuns na base. A ordem de diagnóstico (PHP, depois HTTP error, depois permissão, depois plugin) segue a frequência real observada nos tickets, do mais provável ao mais raro, para reduzir o tempo de correção.</p>
</aside>

---

<h2 id="faq">Perguntas frequentes sobre o erro de upload de mídia</h2>

<details>
  <summary>Por que o WordPress mostra "HTTP error" ao subir uma imagem?</summary>
  <p>"HTTP error" significa que o servidor falhou ao processar a imagem, na maioria das vezes por memória de PHP insuficiente ou ausência da biblioteca GD Library e do Imagick. Subir o memory_limit para 256M no wp-config.php resolve boa parte dos casos. Quando persiste, o ajuste da biblioteca de imagem fica com a hospedagem.</p>
</details>

<details>
  <summary>É possível aumentar o limite de upload sem instalar plugin?</summary>
  <p>Sim, sem nenhum plugin. Edite o upload_max_filesize para 64 MB no php.ini ou no .htaccess na raiz do site. Em PHP modo CGI, o .htaccess falha em silêncio, e o caminho correto passa a ser o painel da hospedagem ou o functions.php do tema. O plugin só troca o arquivo de texto por uma interface, mas o valor aplicado é o mesmo.</p>
</details>

<details>
  <summary>Como saber se o erro de upload de mídia é de permissão de pasta?</summary>
  <p>O sinal clássico é a barra de progresso travar em 0% sem mensagem de erro. Isso indica que a pasta /wp-content/uploads/ não tem permissão de escrita. A correção é aplicar 755 nas pastas e 644 nos arquivos via FTP. Em servidor Apache, vale checar também se o mod_security não está bloqueando o POST.</p>
</details>

<details>
  <summary>O conflito de plugin é uma causa comum do erro de upload?</summary>
  <p>Não, é uma das menos comuns. PHP, HTTP error e permissão de pasta respondem pela maioria dos chamados de upload no suporte da FULL. Conflito de plugin entra na cauda longa: só investigue depois de descartar limite de memória e permissão. O teste é desativar tudo e reativar um a um.</p>
</details>

<details>
  <summary>Por que minha imagem some da biblioteca depois de fazer o upload?</summary>
  <p>A imagem sumir após salvar indica caminho de uploads incorreto gravado no banco de dados, geralmente apontando para um diretório que não existe mais. Confira o campo em Configurações > Mídia e garanta que aponta para wp-content/uploads. Cache agressivo de plugins como o WP Rocket também pode esconder o arquivo recém-enviado até a limpeza do cache.</p>
</details>

---

## 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 <a href="https://full.services/guias/corrigindo-erros-comuns-do-wordpress">corrigindo erros comuns do WordPress</a> reúne os casos em sequência, e o <a href="https://full.services/academy/">FULL Academy</a> organiza tutoriais, guias e reviews em um só lugar.