Adicionar mídia no WordPress não funciona: como corrigir

Tipo Erro interno do WP

Nome do erro Botão Adicionar Mídia não funciona EN: Add Media button not working

Severidade Atenção

Descrição Quando o botão Adicionar Mídia não funciona, ele para de abrir a janela da biblioteca ao ser clicado. Na quase totalidade dos casos é um conflito de JavaScript causado por um plugin, um tema ou um cache que interrompe o carregamento dos scripts da tela de edição.

O que é o botão Adicionar Mídia que não funciona?

No WordPress, o botão Adicionar Mídia abre uma janela (modal) construída em JavaScript que carrega a Biblioteca de Mídia dentro do editor. Para isso funcionar, todos os scripts da tela precisam carregar sem erro. Se um plugin ou o tema injeta um JavaScript com falha, o navegador interrompe a execução naquele ponto e o botão deixa de responder ao clique. O problema é quase sempre de front-end, não de servidor: os arquivos continuam na biblioteca, só a janela para de abrir.

Como identificar

Clicar em “Adicionar mídia” no editor não abre nada: a janela não aparece e a tela fica escurecida ou travada.
O console do navegador (F12) mostra um erro de JavaScript como “Uncaught TypeError” logo após o clique.
A Biblioteca de Mídia em Mídia > Biblioteca carrega em branco ou fica girando o ícone de carregamento.
O problema começou logo após ativar um plugin novo, atualizar um plugin ou trocar de tema.

Como prevenir

Teste plugins novos em um ambiente de homologação antes de ativá-los no site em produção
Mantenha plugins e tema atualizados, já que correções de conflito de JavaScript saem nas novas versões
Limpe o cache do site e do navegador após cada atualização para não servir scripts antigos

Causa

Conflito de JavaScript de um plugin recém-ativado ou atualizado que quebra os scripts da janela de mídia.
Tema com JavaScript próprio na área administrativa interferindo no carregamento do editor.
Cache do navegador ou plugin de cache servindo uma versão antiga e quebrada dos arquivos JS.
Constante CONCATENATE_SCRIPTS ativa em alguns ambientes, combinando scripts e gerando erro de carregamento.
Arquivo de script do core corrompido após uma atualização interrompida do WordPress.

Como resolver

Limpe o cache e teste em aba anônima: limpe o cache do plugin de cache, se houver, e o cache do navegador. Abra o painel em uma aba anônima e teste o botão. Muitas vezes o erro era só um arquivo JS antigo em cache.
Abra o console do navegador: pressione F12, vá na aba Console e clique em Adicionar Mídia. O nome do arquivo .js que aparece no erro costuma apontar para qual plugin ou tema está causando o conflito.
Desative os plugins em bloco: em Plugins, desative todos de uma vez e teste o botão. Se voltar a funcionar, reative um a um, testando após cada ativação, até o erro reaparecer e revelar o culpado.
Troque para um tema padrão: ative temporariamente um tema padrão como o Twenty Twenty-Four. Se o botão passar a funcionar, o conflito está no seu tema, e você deve reportar ao desenvolvedor dele.
Force scripts não concatenados: se nada resolveu, adicione no wp-config.php a constante que desliga a concatenação de scripts do admin, listada no bloco de código, e teste de novo.

PHP

// wp-config.php - desliga a concatenacao de scripts do painel.
// Coloque ANTES da linha "That's all, stop editing!".
// Util quando um script combinado quebra a janela de midia.
define( 'CONCATENATE_SCRIPTS', false );

Perguntas frequentes

Por que o botão Adicionar Mídia parou de abrir?

Na grande maioria dos casos é um conflito de JavaScript. Um plugin, o tema ou um arquivo em cache injeta um script com erro, o navegador interrompe a execução e o botão deixa de responder ao clique. Os arquivos continuam na biblioteca; só a janela para de abrir.

Como descubro qual plugin está causando o conflito?

Desative todos os plugins e teste o botão. Se voltar a funcionar, reative um a um testando após cada ativação. Quando o erro reaparecer, o último plugin ativado é o culpado. O console do navegador (F12) também aponta o arquivo .js envolvido.

Limpar o cache pode resolver sozinho?

Sim, com frequência. Se o navegador ou o plugin de cache estão servindo uma versão antiga e quebrada dos scripts, limpar o cache e testar em aba anônima já faz o botão voltar. Por isso é o primeiro passo antes de mexer em plugins.

O problema pode estar no tema, não num plugin?

Pode. Temas que adicionam JavaScript próprio na área administrativa às vezes interferem no editor. Para checar, ative um tema padrão como o Twenty Twenty-Four e teste. Se o botão funcionar, o conflito é do seu tema e deve ser reportado ao desenvolvedor.

O que é a constante CONCATENATE_SCRIPTS?

É uma configuração do WordPress que combina vários scripts do painel em poucos arquivos para carregar mais rápido. Quando um desses scripts combinados quebra, a janela de mídia falha. Definir CONCATENATE_SCRIPTS como false no wp-config.php separa os scripts e costuma contornar o conflito.

A Biblioteca de Mídia também abre em branco. É o mesmo problema?

Geralmente sim. A tela Mídia > Biblioteca usa os mesmos scripts da janela de Adicionar Mídia. Se ambas falham, o conflito de JavaScript está afetando os dois. A mesma investigação (cache, plugins, tema, console) resolve os dois sintomas de uma vez.

Atenção

Como corrigir o loop Update WordPress Database

O loop Update WordPress Database acontece quando o WordPress pede para atualizar o banco a cada visita e a tela nunca é superada, mesmo depois de clicar no botão. Em geral é causado por cache servindo a tela antiga ou por um descompasso na versão do banco que a rotina de atualização não consegue gravar.

Grave

Como corrigir mídia que não faz upload no WordPress

Quando o upload de mídia no WordPress falha, a imagem ou arquivo não chega à Biblioteca de Mídia. As causas mais comuns são permissões erradas na pasta wp-content/uploads, o limite de tamanho de upload do servidor abaixo do arquivo enviado, ou memória PHP insuficiente para processar a imagem.

Atenção

Como corrigir Another update is currently in progress

Another update in progress aparece quando uma atualização do núcleo do WordPress é interrompida e deixa uma trava registrada no banco de dados. Enquanto a opção core_updater.lock existir, o WordPress recusa qualquer nova atualização até a trava expirar ou ser apagada.

Grave

Como corrigir Publishing failed / Updating failed (REST API)

A falha ao publicar no WordPress (Publishing failed / Updating failed) acontece quando o editor de blocos não consegue falar com a REST API. O Gutenberg salva o post por uma chamada à REST API em /wp-json/; quando essa rota é bloqueada ou responde algo diferente de JSON, o editor exibe o erro mesmo com o conteúdo correto.

Grave

Como corrigir o editor de blocos (Gutenberg) que não carrega

Quando o Gutenberg não carrega, o editor de blocos abre em branco, fica girando ou cai para o Editor Clássico. A causa quase sempre é um erro de JavaScript: cache antigo, minificação que quebra os scripts do editor ou conflito com outro plugin/tema que interrompe a carga da interface.

Atenção

Como corrigir widgets que desapareceram após atualização

Widgets que desapareceram no WordPress após uma atualização costumam ser efeito da tela de widgets em blocos, introduzida no WordPress 5.8. Os widgets continuam no banco; o que muda é a interface, e às vezes um tema FSE remove de vez as áreas de widget clássicas.

Setores

Extensões

Integrações

Como corrigir o botão Adicionar Mídia que não funciona

O que é o botão Adicionar Mídia que não funciona?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o loop Update WordPress Database

Como corrigir mídia que não faz upload no WordPress

Como corrigir Another update is currently in progress

Como corrigir Publishing failed / Updating failed (REST API)

Como corrigir o editor de blocos (Gutenberg) que não carrega

Como corrigir widgets que desapareceram após atualização

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos