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.

Laatst bijgewerkt

Snelle oplossing


  1. Controleer de pagina met de Twitter Card validator.

  2. Stel twitter:card in op summary_large_image en voeg twitter:image of og:image toe.

  3. Gebruik een 2:1-afbeelding van minder dan 5 MB in JPG, PNG, WebP of GIF.

  4. Deel de URL met ?v=2 zodat X deze als een nieuwe link ophaalt.


Waarom de X-card ontbreekt of verouderd is

  • Er is geen twitter:card-tag, of deze is ingesteld op een type dat u niet wilde.

  • robots.txt of een firewall blokkeert Twitterbot. De probleemoplossingsgids van X noemt beide als veelvoorkomende oorzaken.

  • De afbeelding voldoet niet aan de regels. SVG wordt niet ondersteund en bestanden moeten kleiner zijn dan 5 MB.

  • X heeft de oude card gecachet. Volgens de handleiding herindexeert de crawler card-tags ongeveer elke zeven dagen.

  • De afbeeldings-URL is niet veranderd. Caches gebruiken het adres van de afbeelding als sleutel, dus een nieuwe afbeelding heeft een nieuwe URL nodig.

Hoe u dit oplost

  1. Haal de URL door de Twitter card validator om te zien welke card X zal samenstellen.

  2. Voeg <meta name="twitter:card" content="summary_large_image"> toe.

  3. Laat twitter:image of og:image verwijzen naar een unieke afbeelding voor de pagina, niet naar uw logo.

  4. Sta Twitterbot toe in robots.txt en in de regels van uw CDN of firewall.

  5. Deel de link met een querytekenreeks zoals ?v=2 om een nieuwe versie op te halen.

Tags die X leest

  • twitter:card: summary_large_image of summary

  • twitter:title, met terugval op og:title

  • twitter:description, met terugval op og:description

  • twitter:image, met terugval op og:image

  • twitter:image:alt, maximaal 420 tekens

  • twitter:site voor de @gebruikersnaam

Regels voor afbeeldingsformaten

  • Beeldverhouding 2:1 voor summary_large_image

  • Minimaal 300 x 157 px, maximaal 4096 x 4096 px

  • Kleiner dan 5 MB

  • JPG, PNG, WebP of GIF (alleen het eerste frame); geen SVG

Hoe u een vernieuwing forceert

X heeft geen vernieuwingstool. De Card Validator heeft zijn voorbeeldfunctie in 2022 verloren. Deel de URL met een nieuwe querytekenreeks, of wijzig de URL van de afbeelding wanneer u de afbeelding vervangt. Reeds gepubliceerde berichten behouden hun card. De vernieuwingstool bevat de stappen voor elke app.

Niet geverifieerd: X heeft zijn documentatie over cards verwijderd van developer.x.com. De regels op deze pagina zijn afkomstig uit de gearchiveerde versie van 2024 van de documentatie van X en kunnen inmiddels zijn gewijzigd.

Bronnen

Veelgestelde vragen

Welk afbeeldingsformaat werkt voor een Twitter summary_large_image-card?

Een 2:1-afbeelding tussen 300 x 157 px en 4096 x 4096 px, kleiner dan 5 MB, in JPG, PNG, WebP of GIF.

Hoe vernieuw ik een Twitter Card?

Er is geen officiële vernieuwingsknop meer. Deel de URL met een nieuwe querytekenreeks, zodat X deze opnieuw ophaalt.

Maakt X gebruik van Open Graph-tags?

Ja, als fallback. Als twitter:title, twitter:description of twitter:image ontbreken, gebruikt X de og:-versie.

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.