Validateur de Twitter Cards

Quand quelqu’un partage votre lien sur X (Twitter), la plateforme lit les balises meta twitter: de la page pour construire la carte d’aperçu : sa mise en page, son titre, sa description, son image et son attribution. Si ces balises manquent, le lien est publié comme une simple URL, sans carte. Collez le HTML de votre page ci-dessous et ce validateur vérifie que les trois balises requises, twitter:card, twitter:title et twitter:description, sont présentes, en affichant la valeur qu’il lit dans chacune pour que vous puissiez corriger un aperçu cassé avant de publier.

Comment valider votre carte

  1. 1

    Collez le HTML de votre page

    Vous pouvez coller uniquement la section `<head>` ou le document entier. Le validateur n'inspecte que les balises `<meta>`, tout autre balisage est ignoré.

  2. 2

    Il recherche les trois balises requises

    `twitter:card`, `twitter:title` et `twitter:description`, le minimum nécessaire à tout type de carte. Les autres balises comme `twitter:image` ne sont pas vérifiées ici.

  3. 3

    Voyez ce qui a été trouvé

    Chaque balise correspondante est affichée avec la valeur lue dans son attribut `content`, pour que vous puissiez vérifier rapidement la formulation.

  4. 4

    Corrigez ce qui manque

    Toute balise absente parmi les trois est signalée comme manquante. Ajoutez-la à votre `<head>` et recollez le HTML pour revérifier.

Les quatre types de Twitter Cards

La mise en page est définie par la valeur twitter:card. Ce validateur lit la valeur que vous indiquez ; les quatre types pris en charge par X sont :

Type de carte Valeur twitter:card Usage typique
Résumé summary Articles et pages de contenu classiques
Résumé avec grande image summary_large_image Billets de blog avec une image de couverture
Lecteur player Audio ou vidéo intégré
Application app Liens d’installation d’app avec métadonnées du store

Balises requises et recommandées

Cet outil ne vérifie que le premier groupe, les trois balises dont X a besoin pour toute carte.

Requises (vérifiées ici) :

  • twitter:card, la mise en page à utiliser
  • twitter:title, le titre (X affiche environ les 70 premiers caractères)
  • twitter:description, le résumé (X affiche environ les 200 premiers caractères)

Recommandées (non vérifiées ici, mais à ajouter) :

  • twitter:image, une URL absolue https:// vers un PNG, JPG ou GIF ; au moins 300 x 157 px pour une carte résumé et 800 x 418 px pour summary_large_image
  • twitter:site, le @handle de votre marque
  • twitter:creator, le @handle de l’auteur
  • twitter:image:alt, texte alternatif pour l’accessibilité

Erreurs courantes

  • Uniquement des balises Open Graph. X se rabat sur og:title, og:description et og:image, donc le lien s’affiche quand même, mais sans twitter:card la mise en page est un petit résumé par défaut. Ajoutez les deux jeux quand c’est possible.
  • Image trop petite. En dessous de 300 x 157 px, la carte peut se réduire à du texte seul.
  • URL d’image relative. twitter:image doit être absolue (https://...) ; un chemin relatif est ignoré.
  • property= au lieu de name=. X, et ce validateur, lisent les balises Twitter depuis name="twitter:...". Écrire property="twitter:..." fonctionne pour Open Graph mais pas pour celles-ci.
  • Description trop longue. Au-delà d’environ 200 caractères, X la tronque, généralement au milieu d’un mot.

Comment prévisualiser la vraie carte

X a retiré son validateur de cartes officiel (cards-dev.twitter.com/validator) en 2023 : il n’existe donc plus de page officielle affichant un aperçu en direct. Cet outil confirme que les balises requises sont présentes et lisibles ; pour voir la vraie carte, partagez le lien dans un brouillon de publication ou dans un message privé que vous vous envoyez, ou utilisez un vérificateur d’aperçu de liens tiers. Si X continue d’afficher une ancienne image après la correction des balises, ajoutez une chaîne de requête comme ?v=2 à l’URL de l’image pour contourner son cache.

Questions fréquentes

Non. Il lit le HTML que vous collez et confirme que les trois balises twitter: requises sont présentes, en affichant la valeur de chacune. Il ne dessine pas la carte et ne récupère pas votre page en ligne. X a fermé son propre validateur de cartes en 2023 : le moyen fiable de voir la vraie carte est de partager le lien dans un brouillon de publication ou dans un message privé que vous vous envoyez.

X se rabat sur og:title, og:description et og:image, donc le lien s’affiche quand même, mais sans twitter:card la mise en page est un petit résumé par défaut. Pour une carte avec grande image, vous devez définir explicitement twitter:card sur summary_large_image. Notez que ce validateur ne vérifie que les balises twitter:, pas vos balises og:.

Il recherche name="twitter:..." avec l’attribut content écrit après le nom, entre guillemets simples ou doubles. Si votre balise utilise property="twitter:..." au lieu de name=, ou place content avant name, le motif ne correspondra pas même si le HTML est valide. Remettez-la dans l’ordre name="..." content="..." et revérifiez.

Ce validateur reconnaît le nom quelle que soit la casse, donc twitter:Card est aussi détecté ici. Gardez-les tout de même en minuscules (twitter:card), car c’est la forme que X documente et attend.

Brièvement, oui. La vérification s’exécute sur notre serveur : le HTML que vous collez y est envoyé, analysé puis supprimé. Nous ne conservons qu’une trace anonyme de l’utilisation de l’outil, jamais votre balisage, et ce n’est pas un outil hors ligne qui fonctionne dans le navigateur.

Outils similaires

Outil disponible dans d’autres langues