🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir fontes personalizadas que não carregam no Astra Pro

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Fontes personalizadas não carregam no Astra Pro EN: Astra Pro custom fonts not loading
Severidade Atenção
Descrição A fonte personalizada do Astra não carrega quando o site exibe a fonte de fallback no lugar da enviada, porque o plugin Custom Fonts está inativo, o peso do arquivo enviado não bate com o peso escolhido na tipografia, ou o cache de página entrega o head antigo sem o @font-face. A correção ativa o módulo, alinha os pesos e limpa o cache.

O que é a fonte personalizada do Astra que não carrega?

Fontes personalizadas no Astra são arquivos de fonte próprios (woff2, woff, ttf, svg ou eot) que você envia pelo recurso Custom Fonts e depois seleciona na tipografia global do tema. O Astra registra essa fonte via uma regra @font-face e a disponibiliza no seletor de tipografia, dentro do grupo Other System Fonts. Quando o carregamento falha, o navegador não encontra um @font-face válido para a família e o peso pedidos e cai na fonte de sistema de fallback. O resultado é um site que abre normal, mas com a tipografia errada: o texto aparece em Arial, Times ou na fonte padrão do Astra em vez da fonte que você enviou.

Como identificar

  • O texto do site aparece em uma fonte de fallback (Arial, Helvetica ou a padrão do Astra) em vez da fonte personalizada enviada
  • No seletor de tipografia em Aparência -> Personalizar -> Global -> Tipografia, a fonte enviada não aparece no grupo Other System Fonts
  • A aba Rede do navegador mostra a requisição do arquivo de fonte com status 404 Not Found ou 403 Forbidden
  • No console do navegador surge o aviso Failed to decode downloaded font ou OTS parsing error apontando para o arquivo .woff2
  • A fonte certa aparece para você logado no admin, mas o site mostra a fonte de fallback para o visitante anônimo (sintoma de cache)

Como prevenir

  • Envie todos os pesos que você vai usar (Regular e Bold no mínimo) antes de aplicar a fonte na tipografia, para nunca pedir um peso sem arquivo
  • Padronize o formato em woff2 para todas as fontes personalizadas: é o mais leve e o melhor suportado pelos navegadores atuais
  • Inclua a limpeza de cache (plugin e CDN) no checklist sempre que trocar ou subir uma fonte nova
  • Antes de ativar Load Google Fonts Locally ou Remove Unused CSS, teste em ambiente de staging para flagrar bloqueios de fonte antes da produção

Causa

  • O recurso Custom Fonts não está ativo: em Astra Pro o módulo Custom Fonts precisa estar ligado em Aparência -> Astra Options -> ou o plugin gratuito Custom Fonts da Brainstorm Force precisa estar instalado e ativado para o menu Aparência -> Custom Fonts existir.
  • O peso do arquivo enviado não bate com o peso aplicado: você enviou o arquivo no campo de peso 400 (Normal) mas na tipografia pediu 600 (Semi Bold), e como não existe @font-face para 600 o navegador usa fallback.
  • O cache de página (WP Rocket, LiteSpeed, W3 Total Cache ou o cache do servidor) entrega para o visitante uma versão do head gerada antes do upload, sem a regra @font-face nova.
  • O arquivo de fonte foi enviado em formato que o navegador não decodifica (um .ttf renomeado para .woff2, ou um arquivo corrompido), gerando OTS parsing error e queda para fallback.
  • Uma otimização de performance bloqueia a fonte: a opção de carregar Google Fonts localmente, um plugin de remoção de unused CSS, ou o atributo crossorigin ausente em CDN bloqueiam a entrega do arquivo (status 403 na aba Rede).

Como resolver

  1. Confirme que o módulo Custom Fonts está ativo: Verifique se o recurso de fontes personalizadas está habilitado, senão o menu de upload nem existe. No Astra Pro o módulo fica nas opções do tema; na versão gratuita o recurso vem do plugin Custom Fonts da Brainstorm Force. Confirme que o item de menu de fontes aparece no painel antes de seguir.
    Aparência -> Astra Options -> ative o módulo Custom Fonts
    Plugins -> Adicionar novo -> instale e ative Custom Fonts (Brainstorm Force)
    Aparência -> Custom Fonts (o menu deve aparecer após ativar)
  2. Alinhe o peso enviado com o peso aplicado na tipografia: Esta é a causa mais comum. Abra a fonte em Aparência -> Custom Fonts e anote cada peso que você enviou (ex.: só enviou o Regular). Depois, na tipografia global, peça apenas pesos que existem no upload. Se precisar de Bold, envie o arquivo Bold no peso correto em vez de pedir um peso sem arquivo.
    Aparência -> Custom Fonts -> abra a fonte -> confira os Font Weight enviados
    Aparência -> Personalizar -> Global -> Tipografia -> selecione a fonte em Other System Fonts
    Defina apenas variantes que existem no upload (ex.: 400 Normal, 700 Bold) e clique em Publicar
  3. Confira o formato e a integridade do arquivo de fonte: Garanta que o arquivo é de fato um formato de fonte web válido e não um arquivo renomeado. O Astra aceita woff2, woff, ttf, svg e eot. Prefira woff2, que é o formato moderno e mais leve. Se houver OTS parsing error, reconverta a fonte por uma ferramenta confiável e reenvie.
    Formatos aceitos: woff2, woff, ttf, svg, eot
    Reenvie preferindo .woff2 em Aparência -> Custom Fonts -> Add New Font
    Não renomeie a extensão manualmente (um .ttf renomeado para .woff2 quebra a decodificação)
  4. Limpe todos os caches e revalide como visitante: Se a fonte aparece certa para você logado mas errada para o visitante, é cache servindo o head antigo. Limpe o cache do plugin e da CDN, depois abra o site em janela anônima para confirmar a regra @font-face nova no head.
    Limpe o cache do plugin (WP Rocket -> Limpar cache / LiteSpeed -> Purge All)
    Purgue o cache da CDN ou do Cloudflare (Purge Everything)
    Abra o site em janela anônima e confira o arquivo da fonte na aba Rede (status 200)
  5. Desligue otimizações que bloqueiam a fonte: Se a aba Rede mostra 403 ou 404 no arquivo da fonte, uma otimização está bloqueando a entrega. Desative temporariamente a remoção de unused CSS e a opção de hospedar Google Fonts localmente, teste a fonte e religue uma por vez para isolar a responsável.
    Desative Remove Unused CSS no plugin de cache (WP Rocket -> Arquivos CSS)
    Aparência -> Personalizar -> Performance -> desligue Load Google Fonts Locally para teste
    Religue cada otimização uma por vez, limpando o cache entre os testes
CSS
@font-face {
  font-family: 'Minha Fonte';
  src: url('/wp-content/uploads/custom-fonts/minha-fonte.woff2') format('woff2'),
       url('/wp-content/uploads/custom-fonts/minha-fonte.woff') format('woff');
  font-weight: 700;
  font-style: normal;
  font-display: swap;
}

Perguntas frequentes

Onde fica o menu de fontes personalizadas no Astra?
Em Aparência -> Custom Fonts. Esse menu só aparece depois que o módulo Custom Fonts do Astra Pro está ativo ou o plugin gratuito Custom Fonts da Brainstorm Force está instalado e ativado. É por lá que você envia o arquivo e define o peso de cada variante.
Por que minha fonte enviada não aparece no seletor de tipografia?
A fonte enviada aparece no grupo Other System Fonts dentro de Aparência -> Personalizar -> Global -> Tipografia. Se ela não aparece, o módulo Custom Fonts provavelmente está inativo ou o upload não foi salvo. Confirme a ativação e reabra o Personalizar.
Quais formatos de fonte o Astra aceita?
O Astra aceita woff2, woff, ttf, svg e eot. O recomendado é woff2, que é o formato moderno, mais leve e melhor suportado. Evite renomear a extensão de um arquivo, porque isso corrompe a decodificação e gera OTS parsing error no navegador.
A fonte certa aparece pra mim mas errada para os visitantes, por quê?
Isso é cache. O navegador do admin já carregou o head novo com o @font-face, mas o cache de página serve aos visitantes uma versão antiga sem a regra. Limpe o cache do plugin e da CDN e revalide o site em uma janela anônima.
O que significa o erro Failed to decode downloaded font?
Significa que o navegador baixou o arquivo mas não conseguiu interpretá-lo como uma fonte válida. As causas comuns são arquivo corrompido ou extensão trocada manualmente. Reconverta a fonte por uma ferramenta confiável, prefira woff2 e reenvie em Aparência -> Custom Fonts.
O status 403 no arquivo da fonte na aba Rede quer dizer o quê?
O 403 indica que o servidor ou a CDN recusou a entrega do arquivo. Costuma vir de regra de hotlink, de configuração de CORS na CDN ou de uma otimização agressiva. Sirva a fonte do mesmo domínio, ajuste o CORS da CDN e desligue temporariamente otimizações de CSS para isolar a causa.
Preciso do Astra Pro para usar fontes personalizadas?
Não obrigatoriamente. O módulo Custom Fonts vem no Astra Pro, mas a Brainstorm Force também pública o plugin gratuito Custom Fonts, que entrega o mesmo menu Aparência -> Custom Fonts no tema Astra gratuito. Em ambos o fluxo de upload e seleção na tipografia é o mesmo.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes