Como corrigir fontes personalizadas que não carregam no Astra Pro
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
- 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) - 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 - 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) - 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) - 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
@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;
}














