blog
Infraestrutura web

Ícones viraram quadradinhos: conserte o tipo MIME no cPanel

O arquivo está no servidor e chega inteiro ao navegador. O que falta é a etiqueta que diz o que ele é, e você declara isso no painel em poucos minutos.

JR · · 8 min de leitura · 1 tabela

Resposta curta: o navegador recusa a fonte ou a imagem porque o servidor manda o arquivo com o rótulo errado. Na tela Tipos MIME do cPanel você declara font/woff2, image/webp e image/svg+xml, recarrega e os ícones voltam, sem trocar o tema.

Neste artigo
  1. O sintoma: quadradinho no lugar do ícone, fonte que voltou ao padrão
  2. O que é tipo MIME, sem jargão
  3. O que ter em mãos (e por que este ajuste não pede backup)
  4. Como descobrir o rótulo errado na aba Rede do navegador
  5. Como declarar o tipo certo na tela Tipos MIME do cPanel
  6. A etiqueta certa de cada formato, e por que o SVG leva +xml
  7. Como confirmar que o conserto pegou
  8. Quando o quadradinho não tem nada a ver com tipo MIME
  9. O resumo que você pode guardar

O sintoma: quadradinho no lugar do ícone, fonte que voltou ao padrão

Você abre o site e os pequenos símbolos (a lupa da busca, o carrinho, o cadeado) viraram retângulos vazios. Ou a letra bonita do título sumiu e sobrou a fonte comum do navegador. Às vezes é uma foto que não aparece, só o quadro com o ícone de imagem quebrada.

Na maioria das vezes a primeira reação é trocar o tema, instalar um plugin de cache (o cache é a cópia guardada da página, que o navegador ou o site usam para carregar mais rápido e que por isso pode continuar entregando a versão antiga por um tempo) ou mandar o arquivo de novo por FTP (o programa que copia arquivos do seu computador para o servidor). Nada disso resolve quando a causa é a que este artigo trata: o arquivo está lá, intacto, mas o servidor o entrega com o rótulo errado, e o navegador se recusa a usar.

É um conserto de uma linha no painel. Não precisa de terminal, não precisa de programador, não precisa mexer no tema.

O que é tipo MIME, sem jargão

Imagine uma encomenda chegando pelo correio. A caixa tem um conteúdo dentro, e tem uma etiqueta do lado de fora dizendo o que é. O carteiro e o destinatário confiam na etiqueta.

Na web funciona igual. Quando o navegador pede um arquivo ao servidor, o servidor manda o arquivo e, junto, uma etiqueta de texto dizendo que tipo de conteúdo é aquilo. Essa etiqueta se chama tipo MIME (sigla em inglês para Multipurpose Internet Mail Extensions, "extensões multiuso para correio na internet", porque a ideia nasceu no e-mail e depois foi adotada pela web).

Exemplos de etiqueta: text/html para uma página, image/jpeg para uma foto, application/pdf para um PDF.

O navegador é literal. Se a etiqueta diz que aquilo é texto comum, ele trata como texto comum, mesmo que por dentro seja uma fonte. E uma fonte tratada como texto comum não vira letra na tela: vira nada. Daí o quadradinho.

Por que o servidor coloca a etiqueta errada em .woff2, .webp e .svg

O servidor decide a etiqueta pela extensão do arquivo (as letras depois do ponto no nome: .woff2, .webp, .svg). Ele tem uma lista interna de extensões conhecidas.

Quando aparece uma extensão que não está nessa lista, o servidor usa um rótulo genérico, do tipo "arquivo binário qualquer" ou "texto comum". Isso acontece com formatos mais novos em instalações antigas, ou quando alguém mudou configuração do site. O arquivo está perfeito. Só a etiqueta está em branco ou errada.

Como a etiqueta de conteúdo chega ao navegadorNavegador pedeO navegador solicita o arquivoServidor respondeManda o arquivo e a etiquetaNavegador lê a etiquetaConfia no que ela dizEtiqueta erradaFonte vira quadradinho na tela
O arquivo chega inteiro; o que atrapalha é a etiqueta de conteúdo que vem junto.

O que ter em mãos (e por que este ajuste não pede backup)

Tenha em mãos:

Como descobrir o rótulo errado na aba Rede do navegador

Todo navegador moderno tem um painel de inspeção embutido. Ele mostra, um por um, cada arquivo que a página pediu e o que o servidor respondeu.

Abrir o painel de inspeção e ir para a aba Rede

Na página com o problema, clique com o botão direito em qualquer área vazia e escolha Inspecionar. Uma janela se abre, geralmente na lateral ou embaixo. No topo dela há abas: Elementos, Console, Rede (ou Network, se estiver em inglês). Clique em Rede.

Recarregar a página com o painel aberto

A lista começa vazia. Pressione F5 (no Mac, segure Command e pressione R) para recarregar a página. Agora ela se enche de linhas, uma para cada arquivo carregado.

Resultado esperado: dezenas de linhas aparecendo, com nomes como style.css, logo.png, fontawesome.woff2.

Filtrar pela extensão e ler a linha Content-Type

Na caixa de filtro, digite o final do nome do arquivo suspeito: woff2 para fontes e ícones, webp para imagens novas, svg para logotipos e ícones vetoriais.

Clique na linha que aparecer. Abre-se um detalhe com abas; escolha Cabeçalhos (Headers) e procure a linha Content-Type. Esse é o rótulo que o servidor mandou.

O que você quer ver: font/woff2, image/webp ou image/svg+xml, conforme a tabela mais adiante.

O que indica o problema: text/plain (o servidor dizendo que aquilo é texto comum), text/html (dizendo que é uma página), application/octet-stream (o servidor dizendo apenas "arquivo genérico", sem saber o que é), ou a linha simplesmente não existir. Anote a extensão do arquivo e vá para o painel.

Como declarar o tipo certo na tela Tipos MIME do cPanel

O cPanel tem uma tela própria para isso. A documentação oficial do cPanel sobre MIME Types descreve que os tipos MIME relacionam extensões de arquivo ao tipo de conteúdo, e que a tela permite criar tipos definidos pelo usuário, além de listar os tipos já existentes no sistema.

Onde fica a tela Tipos MIME

No cPanel, use a busca do topo e digite MIME. Clique em Tipos MIME (MIME Types), na seção Avançado.

Preencher os campos Tipo MIME e Extensão

Na área de criação há dois campos:

Preencha os dois e confirme. A documentação do cPanel indica que os tipos criados por você passam a constar na lista de tipos MIME definidos pelo usuário, onde também é possível removê-los depois.

Resultado esperado: a nova linha aparece na lista da própria tela.

Uma declaração para cada extensão quebrada

Uma linha por extensão. Se o site usa fonte, imagem WebP e ícone SVG, são três declarações.

A etiqueta certa de cada formato, e por que o SVG leva +xml

Estes são os tipos padronizados de cada formato. Use exatamente a grafia abaixo, tudo em minúsculas, sem espaço.

Formato Extensão (campo Extensão) Tipo MIME (campo Tipo MIME) Onde aparece no site
Fonte web comprimida woff2 font/woff2 Textos com fonte personalizada, ícones de biblioteca
Fonte web (formato anterior) woff font/woff Mesma coisa, em temas mais antigos
Imagem WebP webp image/webp Fotos e banners de temas recentes
Imagem vetorial SVG svg image/svg+xml Logotipos, ícones que não perdem nitidez

Repare no +xml do SVG. Não é enfeite: o SVG é, por dentro, um arquivo de texto estruturado, e o rótulo precisa dizer isso. Escrever image/svg sem o complemento é um dos erros mais comuns e não resolve o problema.

Como confirmar que o conserto pegou

Volte à aba do site. Recarregue ignorando o cache: segure Ctrl e pressione F5 (no Mac, segure Command e Shift e pressione R).

Repita o Passo 1: painel de inspeção, aba Rede, filtro pela extensão, clique no arquivo, aba Cabeçalhos, linha Content-Type.

Resultado esperado: o rótulo agora é o da tabela. E, na tela, o ícone voltou a ser ícone e a fonte voltou a ser a fonte do tema.

O rótulo mudou mas a tela continua errada: é cache

O rótulo não mudou: quatro causas prováveis

Quando o quadradinho não tem nada a ver com tipo MIME

Nem todo quadradinho tem essa causa. Antes de declarar tipos a esmo, confira na aba Rede qual é o código de status da linha do arquivo, que aparece na mesma lista:

Outra pista: se o quadradinho aparece no lugar de um emoji ou de um caractere específico, e não de um ícone do tema, o assunto é codificação de caracteres, não tipo MIME.

Declarar um tipo MIME não tem efeito colateral sobre o resto do site: ele só afeta arquivos daquela extensão. Mas declarar o rótulo errado troca um problema por outro, então vale conferir a grafia na tabela antes de confirmar.

Qual código de status aparece no arquivo quebradoVeja o status na aba RedeNúmero ao lado do arquivo404: arquivo não existeCaminho errado ou envio incompleto403: entrega recusadaQuestão de permissão, não de etiqueta200 com Content-Type erradoAqui sim é tipo MIMEDeclare a extensão no cPanelTela Tipos MIME, uma linha
Confira o código de status antes de declarar qualquer tipo MIME.

O resumo que você pode guardar

O arquivo da fonte ou da imagem está no servidor. O navegador consegue baixar. Ele só não usa, porque a etiqueta de conteúdo que acompanha o download diz outra coisa. Três telas resolvem: a aba Rede do navegador mostra a etiqueta errada, a tela Tipos MIME do cPanel declara a certa, e a aba Rede de novo confirma.

Se depois disso o ícone continuar quadrado, você já não está chutando: tem o nome do arquivo, o código de status e o Content-Type para mostrar a quem for ajudar.

Referências

  1. Documentação oficial (cpanel) — MIME Types. Consultado em 2026-10-29.
Leia também