Twitter Card L'image ne s'affiche pas : 7 causes et solutions

Votre tweet avec un lien ne montre aucune image, juste une URL simple. Voici les 7 causes les plus courantes et comment les résoudre exactement.

Les 7 causes des images Twitter Card manquantes

Lorsqu'une URL partagée sur X (anciennement Twitter) n'affiche pas d'image de carte, il s'agit presque toujours de l'un de ces sept problèmes. Passons en revue chacun d'entre eux.

1. Balise twitter:card manquante ou incorrecte

X nécessite une balise twitter:card explicite. Sans cela, X ne restituera pas du tout une carte, même si vos balises OG sont parfaites.

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Your Title" />
<meta name="twitter:description" content="Your description" />
<meta name="twitter:image" content="https://yoursite.com/image.jpg" />

Il existe deux types de cartes : résumé (petite vignette) et summary_large_image (carte complète). Utilisez summary_large_image pour le meilleur impact visuel.

2. Image trop petite

X a des exigences minimales en matière de taille d'image :

• summary_large_image :  minimum 800×418 pixels
• résumé : minimum 400×150 pixels
• Recommandé : 1200×628 (fonctionne sur toutes les plateformes)

Si votre image est plus petite que le minimum, X laisse tomber la carte silencieusement. Il n'y a pas de message d'erreur : le lien apparaît simplement sous forme de texte brut.

3. URL de l'image non accessible au public

Le robot d'exploration de X doit être capable de récupérer votre image sans authentification. Bloqueurs courants :

• Image derrière un mur de connexion ou une authentification
• Bloqué par robots.txt
• Cloudflare ou CDN renvoyant des erreurs 403/429 aux robots d'exploration
• Restrictions CORS empêchant la récupération d'origines croisées

4. Le cache de Twitter n'a pas été actualisé

Comme toutes les plateformes, X met en cache les données de la carte. Après avoir mis à jour vos balises, X ne récupérera pas les modifications jusqu'à ce que le cache expire ou que vous forciez une actualisation.

<meta property="og:image" content="https://yoursite.com/new-image.jpg" />

Utilisez le Twitter Card Validator pour saisir votre URL et déclencher une actualisation du cache. Le validateur vous montre exactement ce que X voit.

5. Mauvais type MIME ou image corrompue

Si votre serveur d'images renvoie le mauvais type MIME (par exemple, en diffusant un PNG avec le type de contenu image/jpeg), X peut le rejeter. De même, une image corrompue ou partiellement chargée sera supprimée.

6. La page renvoie une erreur au robot d'exploration de Twitter

Si votre page renvoie une erreur 4xx ou 5xx lorsque le robot de Twitter la récupère, aucune carte ne sera générée. Cela peut arriver avec :

• Applications SPA qui nécessitent le rendu de JavaScript (le robot d'exploration de Twitter n'exécute pas JS)
• Géoblocage qui bloque les robots d'exploration basés aux États-Unis
• Cloudflare tourniquets ou CAPTCHA

7. Utiliser uniquement les balises OG sans balises Twitter Card

Alors que X peut revenir aux balises OG, il préfère twitter:card balises. Si vous définissez uniquement og:image et non twitter:image, X risque de ne pas restituer la carte correctement. Réglez toujours les deux.

<!-- Open Graph (for LinkedIn, Discord, Slack, WhatsApp) -->
<meta property="og:image" content="https://yoursite.com/image.jpg" />

<!-- Twitter/X specific (for X/Twitter) -->
<meta name="twitter:image" content="https://yoursite.com/image.jpg" />

Liste de contrôle des solutions rapides

Foire aux questions