# Í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.

> 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.

João Rizzon · 2026-10-30 · Infraestrutura web

---

## 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.

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

Tenha em mãos:

- O **endereço do site** aberto numa aba do navegador, na página onde o problema aparece.
- Acesso ao **painel de controle da hospedagem** (usuário e senha do cPanel). O cPanel é a tela de administração onde você gerencia arquivos, e-mails e domínios do seu plano.
- Saber **qual arquivo está quebrado**. É isso que o passo seguinte descobre.
- Dez minutos. Não precisa de backup para este ajuste, porque ele não altera nenhum arquivo do seu site, apenas instrui o servidor sobre como anunciá-los.

## 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](https://docs.cpanel.net/cpanel/advanced/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:

- **Tipo MIME**: o rótulo. Exemplo: `font/woff2`.
- **Extensão**: a extensão do arquivo, sem o ponto. Exemplo: `woff2`.

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

- **Cache de plugin ou de CDN.** Se você usa um plugin de cache no site, limpe o cache dele. Se usa um serviço intermediário que acelera o site (CDN, rede de distribuição de conteúdo), limpe o cache lá também. O visitante pode estar recebendo a resposta antiga, guardada antes do conserto.
- **Cache do seu próprio navegador.** Teste numa janela anônima ou em outro navegador.

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

- **Extensão escrita com ponto.** O campo pede `woff2`, não `.woff2`.
- **Nome diferente do arquivo real.** Confira se o nome que aparece na aba Rede é exatamente o mesmo do arquivo que está no servidor, inclusive a extensão depois do ponto. Se a página pede `icones.woff2` e no servidor o arquivo é `icones.woff`, a declaração que você criou não vale para ele.
- **Erro de digitação no tipo.** `font/woff2` e `image/svg+xml` precisam estar exatos, sem espaço antes ou depois.
- **Outra configuração sobrescrevendo.** Se um arquivo de configuração do site já define um rótulo para aquela extensão, ele pode prevalecer. Aí vale abrir um chamado no suporte da sua hospedagem descrevendo o que você viu na aba Rede: com o Content-Type anotado, a conversa fica objetiva.

## 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:

- **404**: o arquivo não existe nesse endereço. Problema de caminho ou de upload incompleto, não de etiqueta.
- **403**: o servidor achou o arquivo mas recusou entregar. Questão de permissão.
- **200 com Content-Type errado**: aí sim é o caso deste artigo.

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.

## 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.

