Você publicou a página, compartilhou o link — e a prévia mostra a imagem errada, ou nenhuma imagem. Quase todo problema de OG image se resume a três coisas: tags ausentes, URL de imagem quebrada ou cache desatualizado. Este guia mostra como visualizar sua OG image antes de compartilhar e como corrigir cada falha quando ela acontecer.
Verifique as tags primeiro
Antes de recorrer a qualquer ferramenta, veja o código-fonte da página (Ctrl+U / Cmd+U) e confirme que estas tags existem no <head>:
<meta property="og:title" content="Launch day: v2.0" />
<meta property="og:description" content="Everything new in this release." />
<meta property="og:image" content="https://example.com/og/launch.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />Duas regras pegam a maioria dos bugs de imediato:
og:imageprecisa ser uma URL HTTPS absoluta. Caminhos relativos (/og/launch.png) falham na maioria dos crawlers.- A URL da imagem precisa estar acessível publicamente — abra-a em uma janela anônima. Se exigir login, redirecionar ou retornar 404, nenhuma plataforma conseguirá buscá-la.
Se você nem tem certeza de que a imagem está no tamanho certo, comece pelo nosso guia de tamanho de OG image — as dimensões são a outra metade de uma prévia que funciona.
Ferramentas de prévia por plataforma
Cada grande plataforma oferece um depurador oficial que mostra exatamente o que o crawler dela vê:
| Plataforma | Ferramenta | O que faz |
|---|---|---|
| Sharing Debugger | Mostra o card capturado, lista avisos e oferece o botão "Scrape Again" | |
| Post Inspector | Renderiza a prévia e atualiza o cache do LinkedIn a cada inspeção | |
| X (Twitter) | Escreva um rascunho de post | O X aposentou o preview independente do Card Validator — cole o link em um rascunho (ou mande por DM para você mesmo) para ver o card ao vivo |
| Slack | Mande mensagem para si mesmo | O Slack expande links em tempo real; uma DM para si mesmo é a prévia de OG mais rápida que existe |
| Discord | Cole em qualquer canal | Os embeds renderizam na hora a partir das suas tags Open Graph |
| WhatsApp / Telegram | Envie para "Mensagens salvas" / para si mesmo | Ambos leem og:image; o Telegram faz cache pesado (veja abaixo) |
Um fluxo prático: corrija as tags → rode o Sharing Debugger do Facebook (é o que tem os avisos mais detalhados) → depois confira pontualmente a plataforma que realmente importa para você.
Forçando a atualização do cache
As plataformas fazem cache das prévias de link de forma agressiva — às vezes por semanas. Se você atualizou sua OG image mas continua vendo a antiga:
- Facebook: abra o Sharing Debugger e clique em Scrape Again.
- LinkedIn: passe a URL pelo Post Inspector — a própria inspeção limpa o cache.
- X: não há atualização manual; o cache costuma expirar em cerca de uma semana.
- Telegram: envie sua URL para o
@WebpageBotpara forçar uma nova varredura. - A saída universal: mude a URL da imagem. Acrescentar uma query de versão (
/og/launch.png?v=2) — ou, melhor ainda, usar um nome de arquivo com hash do conteúdo — faz toda plataforma tratá-la como uma imagem novinha na mesma hora.
Se suas OG images são geradas por um pipeline, embuta uma versão ou hash no nome do arquivo desde o primeiro dia. A invalidação de cache deixa de ser um problema por completo.
Por que sua OG image ainda não aparece
Rodou os depuradores e a imagem continua sumida? Percorra esta lista:
- A imagem é grande ou lenta demais. Crawlers dão timeout em arquivos de vários megabytes. Mantenha-a abaixo de 1 MB (bem abaixo de 300 KB para o WhatsApp).
- As dimensões estão abaixo do limite do card grande. Abaixo de 600×315, o Facebook recua para uma miniatura pequena. Exporte em 1200×630 — o guia de tamanhos tem o detalhamento completo.
- Sua página bloqueia crawlers. Verifique se o
robots.txt, um firewall ou uma camada de proteção contra bots não está retornando 403 parafacebookexternalhit,TwitterbotouLinkedInBot. - As tags são injetadas no client-side. A maioria dos crawlers sociais não executa JavaScript. As tags OG precisam estar no HTML renderizado no servidor.
- Múltiplas tags
og:imageem conflito. As plataformas geralmente usam a primeira — remova sobras de templates ou plugins.
Visualize antes de publicar, não depois
Os depuradores acima contam o que deu errado depois do fato. O hábito mais barato é acertar a imagem antes de ela ir ao ar. Nosso gerador gratuito de OG image mostra uma prévia ao vivo nas dimensões exatas de 1200×630 enquanto você edita — o que você vê no editor é, pixel por pixel, o que o card vai exibir — e exporta um PNG otimizado que passa em todas as verificações deste artigo. Sem cadastro, sem marca d'água.
FAQ
Como visualizo minha OG image sem postar?
Use o Sharing Debugger do Facebook ou o Post Inspector do LinkedIn para uma renderização oficial, ou envie o link para si mesmo no Slack, Discord ou WhatsApp — mensagens para si mesmo expandem exatamente como compartilhamentos públicos.
Quanto tempo dura o cache da OG image?
Varia: o Facebook mantém o cache até você forçar uma nova captura, o LinkedIn atualiza via Post Inspector e o X expira sozinho em cerca de uma semana. Mudar a URL da imagem (?v=2 ou um novo nome de arquivo) contorna todos os caches de uma vez.
Por que minha OG image aparece no Facebook mas não no WhatsApp?
Quase sempre é o tamanho do arquivo. O WhatsApp desiste de imagens pesadas — comprima seu PNG ou sirva uma variante menor e mantenha bem abaixo de 300 KB.
Tags OG funcionam em páginas renderizadas com JavaScript?
Só se as tags estiverem presentes na resposta inicial do servidor. Crawlers sociais geralmente não executam JavaScript, então meta tags injetadas no client-side ficam invisíveis para eles.
