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.

Última actualización

Comprueba tu URL

Actualizar vista previa

Validar tarjeta X

Solución rápida


  1. Comprueba la página con el verificador de etiquetas meta.

  2. Sirve las etiquetas en el HTML, con una respuesta 2xx que finalice en menos de 10 segundos.

  3. Añade twitter:card summary_large_image para una imagen grande.

  4. Haz una prueba en el Embed Debugger de Discord o publica con ?v=2.


Por qué el embed de Discord no aparece o está desactualizado

  • Las etiquetas provienen de JavaScript. Discord no ejecuta código, por lo que las etiquetas añadidas tras la carga nunca se detectan.

  • La respuesta no es un 2xx. Se admiten hasta 5 redirecciones, pero la respuesta final debe ser 2xx con text/html.

  • La obtención es demasiado lenta. Todo el proceso de obtención, incluida la medición de imágenes y vídeos, debe completarse en 10 segundos.

  • La protección contra bots bloquea Discordbot. Las páginas se obtienen con Discordbot/2.0 en el user-agent.

  • Discord guardó en caché el embed antiguo. Las vistas previas se almacenan en caché durante unos 30 minutos.

Cómo solucionarlo

  1. Comprueba las etiquetas con el comprobador de metaetiquetas.

  2. Genera og:title, og:description y og:image en el servidor.

  3. Añade og:image:width y og:image:height para que Discord no tenga que descargar la imagen para medirla.

  4. Establece twitter:card en summary_large_image si deseas que la imagen grande aparezca debajo del texto.

  5. Permite el paso de Discordbot en tu CDN y, a continuación, pruébalo en el Embed Debugger o comparte la URL con ?v=2.

Etiquetas que lee Discord

  • og:title o twitter:title, recortado a 70 bytes

  • og:description o twitter:description, recortado a 350 bytes

  • og:site_name mostrado encima del título

  • og:image o twitter:image; dos o más etiquetas og:image crean una galería de hasta 4

  • theme-color para la barra de énfasis, como #RRGGBB o #RRGGBBAA

  • twitter:card y og:type para el diseño

Reglas de tamaño de imagen

  • Formatos: PNG, GIF, JPG, WebP y AVIF

  • Declarar og:image:width y og:image:height

  • Hasta 4 imágenes por enlace

  • Obtención completa en menos de 10 segundos y 50 MB

No verificado: Discord no publica un tamaño mínimo o recomendado en píxeles. 1200 x 630 px es una opción segura.

Cómo forzar una actualización

Discord guarda en caché las vistas previas durante unos 30 minutos. Para ver los cambios ahora, comparte la URL con una nueva cadena de consulta como ?v=2, o compruébala en el Embed Debugger. La herramienta de actualización muestra el paso para cada aplicación.

Fuentes

Preguntas frecuentes

¿Por qué Discord muestra una imagen pequeña en lugar de una grande?

Sin etiquetas de diseño, Discord muestra el texto con una imagen pequeña. Configura twitter:card como summary_large_image para el diseño grande.

¿Cuánto tiempo guarda Discord las incrustaciones en caché?

Unos 30 minutos, según la documentación para desarrolladores de Discord. Utiliza una nueva cadena de consulta (query string) para probar los cambios.

¿Ejecuta Discord JavaScript cuando crea un embed?

No. Discord no ejecuta ningún código, por lo que las etiquetas deben estar en el HTML que envía tu servidor.

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 Slack no funciona o no se actualiza

Slack despliega los enlaces con un bot que lee las etiquetas oEmbed, Open Graph y Twitter Card. Los resultados se guardan en la caché de Slack durante unos 30 minutos.

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.

La vista previa de los enlaces de WhatsApp no funciona o no aparece

WhatsApp tiene límites estrictos: el head debe estar dentro de los primeros 300 KB del HTML y la imagen debe pesar menos de 600 KB. Si no cumples alguno, la vista previa será pequeña o no aparecerá.