og:image Não Aparece? Como Corrigir
Um og:image que não aparece quase sempre se resume a uma de cinco causas: a URL da imagem não é pública, a imagem é grande demais, a plataforma armazenou em cache uma versão antiga, as tags apontam para a página errada ou o formato da imagem não é suportado. Este guia aborda cada correção com as ferramentas de depuração que Facebook, X e LinkedIn fornecem.
Por que minha og:image não está sendo exibida?
Na maioria das vezes, a URL da imagem não é publicamente acessível, o arquivo excede os limites da plataforma, ou a plataforma está mostrando uma cópia em cache. As plataformas sociais re-rastreiam em um cronograma e fazem cache de forma agressiva, então uma imagem nova muitas vezes parece "não funcionar" até que você force uma atualização com as ferramentas de depuração delas.
As cinco causas mais comuns (e as correções)
1. A URL da imagem não é pública
As plataformas precisam buscar a imagem sem autenticação. Uma URL protegida por login, localhost ou um endereço IP falhará.
Correção: hospede a imagem em uma URL pública, com HTTPS, e confirme que curl -I <image-url> retorna 200 OK com uma imagem Content-Type.
2. A imagem é grande demais
A maioria das plataformas limita imagens OG a 8 MB (X em ~5 MB). Um PNG enorme falha silenciosamente.
Correção: mantenha o arquivo abaixo de 5 MB; um card de texto 1200×630 normalmente tem 200–500 KB. No FastOG, a saída PNG já é dimensionada para isso.
3. A plataforma armazenou uma versão antiga em cache
Facebook, X, LinkedIn, Slack e Discord fazem cache de forma agressiva. O Meta também guarda uma cópia própria da imagem e vincula a pré-visualização à URL da página, então uma nova URL de imagem sozinha não resolve. Após alterar a imagem, o card antigo persiste por horas ou dias.
Correção: force uma nova varredura com a ferramenta da plataforma (abaixo). Para imagens que mudam, use uma URL que varie com o conteúdo (as URLs assinadas do FastOG fazem isso automaticamente). Para a única plataforma que permite uma atualização programática, veja Force a Facebook Open Graph Cache Refresh.
4. URL errada ou página errada
A tag og:image pode estar ausente, duplicada ou apontando para uma página sem essa tag.
Correção: visualize o código-fonte da página e confirme que a tag og:image está presente, renderizada no servidor e absoluta.
5. Formato não suportado
Algumas plataformas rejeitam certos formatos ou imagens animadas.
Correção: use PNG ou JPG; 1200×630 é a proporção suportada.
Ferramentas de depuração
| Plataforma | Ferramenta |
|---|---|
| Facebook / WhatsApp | Sharing Debugger — developers.facebook.com/tools/debug |
| X / Twitter | Card Validator — cards-dev.twitter.com/validator |
Post Inspector — linkedin.com/post-inspector |
Cole a URL e clique em "Scrape" / "Refresh" para buscar as tags mais recentes.
Especificidades do FastOG
- O FastOG renderiza PNG de 1200×630 — o tamanho suportado — evitando problemas de dimensão/proporção.
- URLs assinadas protegem apenas o primeiro render; as imagens em cache permanecem válidas, então um card compartilhado continua funcionando.
- Altere o título → altere a URL → um novo render. A plataforma (eventualmente) capta o novo card quando você força um novo rastreamento.
FAQ
O FastOG garante que minha og:image apareça?
O FastOG entrega um PNG válido de 1200×630 a partir de uma URL pública. Se a plataforma o exibe depende do cache dela — faça um novo scrape com o validador após alterar uma imagem.
Por que o Facebook mostra uma imagem antiga mesmo depois de eu atualizá-la?
O Facebook armazena em cache os scrapes e mantém uma cópia própria da imagem — portanto, uma nova URL og:image sozinha não resolve. Use o Sharing Debugger → "Scrape Again"; o artigo Force a Facebook Open Graph Cache Refresh cobre o caminho da API, o token de aplicativo necessário e os limites de taxa a respeitar.
Como forço o X a mostrar meu novo card?
Abra o X Card Validator e cole a URL. Ele busca novamente as versões mais recentes de og:image e twitter:image.