Discord-embed wordt niet weergegeven of niet bijgewerkt

Discord haalt de pagina één keer op, leest de tags in de server-HTML en slaat de embed ongeveer 30 minuten op in de cache. Het voert je JavaScript nooit uit.

Laatst bijgewerkt

Controleer je URL

Voorbeeld vernieuwen

X-kaart valideren

Snelle oplossing


  1. Controleer de pagina met de metatag-checker.

  2. Lever de tags in de HTML aan, met een 2xx-respons die binnen 10 seconden is voltooid.

  3. Voeg twitter:card summary_large_image toe voor een grote afbeelding.

  4. Test in de Embed Debugger van Discord of plaats een bericht met ?v=2.


Waarom de Discord-embed ontbreekt of verouderd is

  • De tags zijn afkomstig van JavaScript. Discord voert geen code uit, dus tags die na het laden worden toegevoegd, worden nooit gezien.

  • Het antwoord is geen 2xx. Omleidingen zijn prima tot maximaal 5, maar het uiteindelijke antwoord moet 2xx zijn met text/html.

  • Het ophalen is te traag. Het hele ophaalproces, inclusief het meten van afbeeldingen en video, moet binnen 10 seconden zijn voltooid.

  • Botbeveiliging blokkeert Discordbot. Pagina's worden opgehaald met Discordbot/2.0 in de user-agent.

  • Discord heeft de oude embed gecachet. Voorvertoningen worden ongeveer 30 minuten gecachet.

Hoe u dit kunt oplossen

  1. Lees de tags met de meta tag checker.

  2. Render og:title, og:description en og:image op de server.

  3. Voeg og:image:width en og:image:height toe, zodat Discord de afbeelding niet hoeft op te halen om deze te meten.

  4. Stel twitter:card in op summary_large_image als u de grote afbeelding onder de tekst wilt tonen.

  5. Laat Discordbot toe via uw CDN, en test vervolgens in de Embed Debugger of plaats de URL met ?v=2.

Tags die Discord leest

  • og:title of twitter:title, afgekapt op 70 bytes

  • og:description of twitter:description, afgekapt op 350 bytes

  • og:site_name weergegeven boven de titel

  • og:image of twitter:image; twee of meer og:image-tags vormen een galerij van maximaal 4

  • theme-color voor de accentbalk, als #RRGGBB of #RRGGBBAA

  • twitter:card en og:type voor de lay-out

Regels voor afbeeldingsgrootte

  • Formaten: PNG, GIF, JPG, WebP en AVIF

  • Declareer og:image:width en og:image:height

  • Tot maximaal 4 afbeeldingen per link

  • Het hele ophaalproces binnen 10 seconden en 50 MB

Niet geverifieerd: Discord publiceert geen minimale of aanbevolen pixelgrootte. 1200 x 630 px is een veilige keuze.

Hoe u een vernieuwing forceert

Discord cachet voorvertoningen ongeveer 30 minuten. Om wijzigingen direct te zien, deelt u de URL met een nieuwe query-tekenreeks zoals ?v=2, of controleert u deze in de Embed Debugger. De vernieuwingstool toont de stap voor elke app.

Bronnen

Veelgestelde vragen

Waarom toont Discord een kleine afbeelding in plaats van een grote?

Zonder lay-outtags toont Discord tekst met een kleine afbeelding. Stel twitter:card in op summary_large_image voor de grote lay-out.

Hoe lang bewaart Discord embeds in de cache?

Ongeveer 30 minuten, volgens de documentatie voor ontwikkelaars van Discord. Gebruik een nieuwe query string om wijzigingen te testen.

Voert Discord JavaScript uit wanneer het een embed bouwt?

Nee. Discord voert geen code uit, dus de tags moeten aanwezig zijn in de HTML die je server verzendt.

Controleer je pagina en vernieuw vervolgens het voorbeeld

Plak je URL in de gratis checker om te zien welke tags elke app precies uitleest. Zodra de tags kloppen, gebruik je de vernieuwingstool om het oude voorbeeld te wissen.

Controleer je URL

Voorbeeld vernieuwen

X-kaart valideren

Gerelateerde gidsen

Slack-linkvoorbeeld werkt niet of wordt niet bijgewerkt

Slack vouwt links uit met behulp van een bot die oEmbed-, Open Graph- en Twitter Card-tags leest. De resultaten worden binnen Slack ongeveer 30 minuten gecachet.

X (Twitter)-card wordt niet weergegeven of niet bijgewerkt

X genereert de kaart op basis van twitter:-tags, en valt terug op og:-tags. Er is geen validator meer die de cache ververst, dus de oplossing is goede tags plus een nieuwe URL.

WhatsApp-linkvoorbeeld werkt niet of wordt niet weergegeven

WhatsApp hanteert strikte limieten: de head moet binnen de eerste 300 KB van de HTML staan en de afbeelding moet kleiner zijn dan 600 KB. Als je er eentje mist, krijg je een kleine voorvertoning of helemaal niets.