A imagem og:image não aparece? Como corrigir
Uma imagem og:image que não aparece quase sempre se deve a uma de cinco causas: o URL da imagem não é público, a imagem é demasiado grande, a plataforma guardou 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 o Facebook, o X e o LinkedIn disponibilizam.
Porque é que a minha og:image não é apresentada?
Na maioria dos casos, o URL da imagem não é publicamente acessível, o ficheiro excede os limites da plataforma, ou a plataforma está a mostrar uma cópia em cache. As plataformas sociais reanalisam o conteúdo num horário definido e fazem cache de forma agressiva, pelo que uma imagem nova muitas vezes parece "não funcionar" até forçar uma atualização com as ferramentas de depuração delas.
As cinco causas mais comuns (e respetivas correções)
1. O URL da imagem não é público
As plataformas têm de obter a imagem sem autenticação. Um URL protegido por login, localhost ou um endereço IP falhará.
Correção: aloje a imagem num URL público, com HTTPS, e confirme que curl -I <image-url> devolve 200 OK com um Content-Type de imagem.
2. A imagem é demasiado grande
A maioria das plataformas limita as imagens OG a 8 MB (X a ~5 MB). Um PNG enorme falha silenciosamente.
Correção: mantenha o ficheiro abaixo dos 5 MB; um cartão de texto de 1200×630 costuma ter 200–500 KB. No FastOG, o resultado PNG já é dimensionado para este efeito.
3. A plataforma guardou em cache uma versão antiga
O Facebook, o X, o LinkedIn, o Slack e o Discord fazem cache de forma agressiva. A Meta também guarda a sua própria cópia da imagem e associa a pré-visualização ao URL da página, pelo que um novo URL de imagem, por si só, não a altera. Depois de mudar a imagem, o cartão antigo persiste durante horas ou dias.
Correção: force uma nova recolha com a ferramenta da plataforma (abaixo). Para imagens que mudam, use um URL que mude com o conteúdo (os URLs assinados do FastOG fazem isto automaticamente). Para a única plataforma que permite uma atualização programática, consulte Force a Facebook Open Graph Cache Refresh.
4. URL errado ou página errada
A tag og:image pode estar em falta, duplicada ou a apontar para uma página sem essa tag.
Correção: veja 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 o URL e, em seguida, clique em "Scrape" / "Refresh" para obter as tags mais recentes.
Especificidades do FastOG
- O FastOG gera PNG de 1200×630 — o tamanho suportado — evitando assim problemas de dimensão/proporção.
- Os URLs assinados limitam apenas o primeiro render; as imagens em cache permanecem válidas, pelo que um cartão partilhado continua a funcionar.
- Altere o título → altere o URL → um novo render. A plataforma (eventualmente) deteta o novo cartão quando força um novo rastreio.
FAQ
O FastOG garante que a minha og:image aparece?
O FastOG entrega um PNG válido de 1200×630 a partir de um URL público. Se a plataforma o mostra ou não depende da cache dela — volte a fazer o scrape com o validador depois de alterar uma imagem.
Porque é que o Facebook mostra uma imagem antiga mesmo depois de a ter atualizado?
O Facebook guarda em cache os scrapes e mantém a sua própria cópia da imagem — por isso, um novo URL og:image por si só não resolve. Use o Sharing Debugger → "Scrape Again"; Force a Facebook Open Graph Cache Refresh cobre o caminho da API, o token da aplicação necessário e os limites de taxa a respeitar.
Como é que forço o X a mostrar o meu novo cartão?
Abra o X Card Validator e cole o URL. Ele volta a obter os dados mais recentes de og:image e twitter:image.