La tarjeta de X (Twitter) no se muestra o no se actualiza

X genera la tarjeta a partir de las etiquetas twitter: y, en su defecto, de las etiquetas og:. Ya no existe un validador que actualice la caché, por lo que la solución pasa por usar las etiquetas correctas y una URL nueva.

Última actualización

Comprueba tu URL

Actualizar vista previa

Validar tarjeta X

Solución rápida


  1. Comprueba la página con el validador de tarjetas de Twitter.

  2. Establece twitter:card como summary_large_image y añade twitter:image u og:image.

  3. Utiliza una imagen con relación de aspecto 2:1 de menos de 5 MB en formato JPG, PNG, WebP o GIF.

  4. Comparte la URL con ?v=2 para que X la obtenga como un enlace nuevo.


Por qué la tarjeta de X no aparece o está desactualizada

  • No existe la etiqueta twitter:card o está configurada con un tipo no deseado.

  • robots.txt o un cortafuegos bloquea a Twitterbot. La guía de resolución de problemas de X enumera ambos como causas comunes.

  • La imagen no cumple alguna regla. SVG no es compatible y los archivos deben ocupar menos de 5 MB.

  • X guardó en caché la tarjeta antigua. Su guía indica que el rastreador vuelve a indexar las etiquetas de las tarjetas aproximadamente cada siete días.

  • La URL de la imagen no ha cambiado. La caché toma como clave la dirección de la imagen, por lo que una imagen nueva necesita una URL nueva.

Cómo solucionarlo

  1. Pase la URL por el validador de tarjetas de Twitter para ver la tarjeta que generará X.

  2. Añada <meta name="twitter:card" content="summary_large_image">.

  3. Apunte twitter:image u og:image a una imagen exclusiva para la página, no a su logotipo.

  4. Permita Twitterbot en robots.txt y en las reglas de su CDN o cortafuegos.

  5. Comparta el enlace con una cadena de consulta como ?v=2 para forzar una nueva obtención.

Etiquetas que lee X

  • twitter:card: summary_large_image o summary

  • twitter:title, recurriendo a og:title

  • twitter:description, recurriendo a og:description

  • twitter:image, recurriendo a og:image

  • twitter:image:alt, hasta 420 caracteres

  • twitter:site para el @nombredeusuario

Reglas de tamaño de imagen

  • Relación de aspecto 2:1 para summary_large_image

  • Mínimo 300 x 157 px, máximo 4096 x 4096 px

  • Menos de 5 MB

  • JPG, PNG, WebP o GIF (solo el primer fotograma); no SVG

Cómo forzar una actualización

X no dispone de una herramienta de actualización. El validador de tarjetas perdió su vista previa en 2022. Comparta la URL con una nueva cadena de consulta o cambie la URL de la imagen cuando la sustituya. Las publicaciones ya publicadas conservan su tarjeta. La herramienta de actualización incluye los pasos para cada aplicación.

No verificado: X eliminó la documentación sobre tarjetas de developer.x.com. Las reglas de esta página proceden de la versión archivada de 2024 de la documentación de X y pueden haber cambiado.

Fuentes

Preguntas frecuentes

¿Qué tamaño de imagen funciona para una tarjeta summary_large_image de Twitter?

Una imagen de proporción 2:1 de entre 300 x 157 px y 4096 x 4096 px, de menos de 5 MB, en formato JPG, PNG, WebP o GIF.

¿Cómo actualizo una Twitter card?

Ya no hay un botón de actualización oficial. Comparte la URL con una nueva cadena de consulta para que X la vuelva a obtener.

¿Utiliza X etiquetas Open Graph?

Sí, como alternativa. Si faltan twitter:title, twitter:description o twitter:image, X utiliza la versión og:.

Comprueba tu página y, a continuación, actualiza la vista previa

Pega tu URL en el comprobador gratuito para ver las etiquetas exactas que lee cada aplicación. Una vez que las etiquetas sean correctas, usa la herramienta de actualización para borrar la vista previa antigua.

Comprueba tu URL

Actualizar vista previa

Validar tarjeta X

Guías relacionadas

La vista previa del enlace de LinkedIn no funciona o no se actualiza

LinkedIn genera la tarjeta a partir de cuatro etiquetas og: y guarda una copia en caché. Corrige las etiquetas y, después, haz que LinkedIn vuelva a rastrear la página con Post Inspector.

El embed de Discord no se muestra o no se actualiza

Discord obtiene la página una vez, lee las etiquetas en el HTML del servidor y almacena en caché la vista previa durante unos 30 minutos. Nunca ejecuta tu JavaScript.

La imagen Open Graph de Next.js no funciona

La mayoría de los errores de vista previa en Next.js se deben a la API de Metadata: la falta de metadataBase, un objeto openGraph que sustituye al elemento principal o un archivo de imagen que supera el límite permitido.