¿No aparece la imagen og:image? Cómo solucionarlo

Que no aparezca la imagen og:image casi siempre se debe a una de cinco causas: la URL de la imagen no es pública, la imagen es demasiado grande, la plataforma ha guardado en caché una versión antigua, las etiquetas apuntan a la página equivocada o el formato de la imagen no es compatible. Esta guía explica cada solución con las herramientas de depuración que ofrecen Facebook, X y LinkedIn.

¿Por qué no se muestra mi og:image?

La mayoría de las veces, la URL de la imagen no es accesible públicamente, el archivo supera los límites de la plataforma o la plataforma está mostrando una copia en caché. Las plataformas sociales vuelven a rastrear según un calendario y almacenan en caché de forma agresiva, por lo que una imagen nueva suele parecer que «no funciona» hasta que fuerzas una actualización con sus herramientas de depuración.

Las cinco causas más comunes (y sus soluciones)

1. La URL de la imagen no es pública

Las plataformas deben obtener la imagen sin autenticación. Una URL detrás de un login, localhost o una dirección IP fallará.

Solución: aloja la imagen en una URL pública con HTTPS y confirma que curl -I <image-url> devuelve 200 OK con una imagen Content-Type.

2. La imagen es demasiado grande

La mayoría de las plataformas limitan las imágenes OG a 8 MB (X a ~5 MB). Un PNG enorme falla silenciosamente.

Solución: mantén el archivo por debajo de 5 MB; una tarjeta de texto de 1200×630 suele ocupar entre 200 y 500 KB. En FastOG, la salida PNG ya está dimensionada para esto.

3. La plataforma guardó en caché una versión antigua

Facebook, X, LinkedIn, Slack y Discord guardan en caché de forma agresiva. Meta también almacena su propia copia de la imagen y vincula la vista previa a la URL de la página, así que una URL de imagen nueva por sí sola no la actualizará. Después de cambiar la imagen, la tarjeta antigua persiste durante horas o días.

Solución: fuerza un rastreo con la herramienta de la plataforma (abajo). Para cambiar imágenes, usa una URL que cambie con el contenido (las URLs firmadas de FastOG hacen esto automáticamente). Para la única plataforma que permite una actualización programática, consulta Forzar una actualización de caché de Open Graph en Facebook.

4. URL incorrecta o página equivocada

La etiqueta og:image puede faltar, estar duplicada o apuntar a una página sin esa etiqueta.

Solución: revisa el código fuente de la página y confirma que la etiqueta og:image está presente, renderizada en el servidor y es absoluta.

5. Formato no compatible

Algunas plataformas rechazan ciertos formatos o imágenes animadas.

Solución: usa PNG o JPG; 1200×630 es la proporción compatible.

Herramientas de depuración

Plataforma	Herramienta
Facebook / WhatsApp	Sharing Debugger — `developers.facebook.com/tools/debug`
X / Twitter	Card Validator — `cards-dev.twitter.com/validator`
LinkedIn	Post Inspector — `linkedin.com/post-inspector`

Pega la URL y luego pulsa "Scrape" / "Refresh" para obtener las últimas etiquetas.

Particularidades de FastOG

FastOG genera PNG de 1200×630, el tamaño admitido, por lo que se evitan problemas de tamaño o proporción.
Las URL firmadas solo protegen el primer renderizado; las imágenes en caché siguen siendo válidas, por lo que una tarjeta compartida sigue funcionando.
Cambia el título → cambia la URL → un nuevo renderizado. La plataforma (eventualmente) detecta la nueva tarjeta cuando fuerzas un re-scrape.

FAQ

¿Garantiza FastOG que aparezca mi og:image?

FastOG entrega un PNG válido de 1200×630 desde una URL pública. Que la plataforma lo muestre depende de su caché: vuelve a hacer el scrape con el validador después de cambiar una imagen.

¿Por qué Facebook muestra una imagen antigua incluso después de actualizarla?

Facebook guarda en caché los scrapes y mantiene su propia copia de la imagen, así que una URL nueva de og:image por sí sola no lo cambiará. Usa Sharing Debugger → "Scrape Again"; Force a Facebook Open Graph Cache Refresh cubre la ruta de la API, el token de la app que necesita y los límites de tasa que debes respetar.

¿Cómo fuerzo a X a mostrar mi nueva tarjeta?

Abre el X Card Validator y pega la URL. Vuelve a obtener los últimos og:image y twitter:image.