Guide de correction

Comment ajouter des balises Twitter Card dans WordPress

8 février 2026 Mis à jour le 19 avr. 2026

Lorsque quelqu'un partage votre page WordPress sur X (anciennement Twitter), la plateforme recherche les balises meta Twitter Card pour générer un aperçu enrichi avec une image, un titre et une description. Sans ces balises, les liens partagés apparaissent comme de simples URL en texte brut, ce qui réduit considérablement les taux de clics et l'engagement global. Les Twitter Cards sont l'un des moyens les plus simples de faire ressortir votre contenu dans les fils sociaux, et leur configuration ne prend que quelques minutes.

Comprendre les types de Twitter Cards et leur impact

Avant de plonger dans la mise en œuvre, il est utile de comprendre quels types de Twitter Cards existent et quand utiliser chacun :

  • Summary Card : Affiche une petite vignette carrée à côté du titre et de la description. Fonctionne bien pour les pages d'accueil, les pages de catégorie et le contenu où l'image est secondaire par rapport au texte.
  • Summary Card with Large Image : Affiche une grande image mise en évidence au-dessus du titre et de la description. C'est le meilleur choix pour les articles de blog, les articles, les pages produits et tout contenu où un aperçu visuel augmente l'engagement.
  • Player Card : Intègre un lecteur vidéo ou audio directement dans le tweet. Nécessite l'approbation de X et est utilisé par les plateformes de médias comme YouTube ou SoundCloud.
  • App Card : Conçue pour la promotion d'applications mobiles avec un lien de téléchargement direct. Nécessite également l'approbation de X.

Pour la plupart des sites WordPress, la Summary Card with Large Image est le meilleur choix par défaut. Les études montrent systématiquement que les tweets avec de grandes images reçoivent 2 à 3 fois plus d'engagement que les tweets en texte uniquement. L'élément visuel attire l'œil lorsque les utilisateurs font défiler leur fil, les rendant plus susceptibles de s'arrêter et de cliquer.

Balises meta Twitter Card requises expliquées

Chaque Twitter Card nécessite un ensemble spécifique de balises meta dans la section <head> de votre page. Voici ce que fait chaque balise :

  • twitter:card : Définit le type de carte. Définissez-la sur summary ou summary_large_image.
  • twitter:title : Le titre affiché dans la carte. Gardez-le sous 70 caractères pour éviter la troncature.
  • twitter:description : Un bref résumé du contenu. Gardez-le sous 200 caractères. Ce texte apparaît sous le titre dans l'aperçu de la carte.
  • twitter:image : L'URL de l'image affichée dans la carte. Pour les cartes summary_large_image, utilisez des images d'au moins 1200 x 628 pixels. Pour les cartes summary, les images doivent être d'au moins 144 x 144 pixels. La taille maximale du fichier est de 5 Mo.
  • twitter:image:alt : Texte alternatif pour l'image, important pour l'accessibilité. Décrivez le contenu de l'image en moins de 420 caractères.
  • twitter:site : Le pseudonyme X de votre site web (par exemple, @VotreSite). Ceci est facultatif mais aide à l'attribution.
  • twitter:creator : Le pseudonyme X de l'auteur du contenu. Utile pour les blogs multi-auteurs.

X prend également en charge un mécanisme de repli. Si les balises Twitter Card sont manquantes, la plateforme tentera d'utiliser les balises Open Graph (og:title, og:description, og:image) à la place. Cela signifie que si vous avez déjà configuré les balises Open Graph, vos liens obtiendront des aperçus de base même sans balises Twitter Card dédiées. Cependant, ajouter des balises Twitter Card explicites vous donne plus de contrôle sur la façon dont votre contenu apparaît spécifiquement sur X.

Ajouter des Twitter Cards avec Yoast SEO

Yoast SEO est l'extension SEO WordPress la plus populaire, et elle inclut une prise en charge intégrée des Twitter Cards. Si vous utilisez déjà Yoast, l'activation des Twitter Cards ne prend que quelques clics :

  1. Allez dans SEO > Réseaux sociaux dans votre panneau d'administration WordPress.
  2. Cliquez sur l'onglet X (Twitter).
  3. Activez « Ajouter les métadonnées Twitter Card ».
  4. Sélectionnez le type de carte par défaut. Choisissez Résumé avec grande image pour la plupart des sites.
  5. Enregistrez vos modifications.

À partir de ce moment, Yoast génère automatiquement les balises Twitter Card pour chaque article et page de votre site, en récupérant le titre, la description et l'image mise en avant à partir de votre contenu.

Pour personnaliser la Twitter Card pour un article spécifique, ouvrez l'éditeur d'articles et faites défiler jusqu'à la méta-boîte Yoast. Cliquez sur l'onglet Réseaux sociaux (l'icône de partage), puis sélectionnez l'onglet X. Vous pouvez ici remplacer le titre, la description et l'image par défaut pour cette page particulière. C'est utile lorsque vous voulez que l'aperçu social diffère du titre SEO de la page, par exemple en utilisant un titre plus accrocheur pour le partage social.

Ajouter des Twitter Cards avec Rank Math

Rank Math est une autre extension SEO populaire avec une intégration complète aux réseaux sociaux :

  1. Allez dans Rank Math > Titles & Meta > Global Meta.
  2. Faites défiler jusqu'à la section Social Meta.
  3. Activez le Twitter Card Type et sélectionnez votre format de carte préféré.
  4. Saisissez éventuellement votre nom d'utilisateur X par défaut dans les champs Twitter.
  5. Enregistrez vos modifications.

Pour la personnalisation par article, ouvrez n'importe quel article ou page dans l'éditeur. Cliquez sur l'icône Rank Math dans la barre d'outils supérieure, puis accédez à l'onglet Réseaux sociaux. Passez à la section X pour définir des titres, descriptions et images personnalisés pour ce contenu spécifique.

Rank Math vous permet également de définir différentes images sociales par article, ce qui est utile lorsque votre image mise en avant n'a pas le bon ratio d'aspect pour les Twitter Cards. Vous pouvez télécharger une image distincte de 1200 x 628 pixels spécifiquement optimisée pour le partage social.

Ajouter des Twitter Cards avec All in One SEO (AIOSEO)

All in One SEO offre également une fonctionnalité Twitter Card :

  1. Naviguez vers All in One SEO > Réseaux sociaux.
  2. Cliquez sur l'onglet X (Twitter).
  3. Activez Twitter Card et choisissez votre type de carte par défaut.
  4. Saisissez le nom d'utilisateur X de votre site.
  5. Configurez les paramètres par défaut des articles et des pages.
  6. Enregistrez les modifications.

AIOSEO propose également des paramètres Twitter Card par article dans l'éditeur d'articles sous le panneau Paramètres AIOSEO, onglet Réseaux sociaux.

Implémentation manuelle des Twitter Cards sans extension

Si vous préférez ne pas utiliser d'extension SEO, ou si vous avez besoin d'un contrôle total sur la sortie, vous pouvez ajouter manuellement les balises Twitter Card via le fichier functions.php de votre thème ou une extension personnalisée spécifique au site :

function custom_twitter_cards() {
    if (is_singular()) {
        global $post;
        $title = get_the_title();
        $url = get_permalink();

        // Générer la description à partir de l'extrait ou du contenu
        $excerpt = has_excerpt()
            ? wp_strip_all_tags(get_the_excerpt())
            : wp_trim_words(wp_strip_all_tags($post->post_content), 30);

        // Récupérer l'image mise en avant
        $image = get_the_post_thumbnail_url($post->ID, 'large');

        // Récupérer le pseudonyme Twitter de l'auteur depuis les méta utilisateur
        $author_twitter = get_the_author_meta('twitter', $post->post_author);

        echo '<meta name="twitter:card" content="summary_large_image" />' . "\n";
        echo '<meta name="twitter:title" content="' . esc_attr($title) . '" />' . "\n";
        echo '<meta name="twitter:description" content="' . esc_attr($excerpt) . '" />' . "\n";
        echo '<meta name="twitter:url" content="' . esc_url($url) . '" />' . "\n";

        if ($image) {
            echo '<meta name="twitter:image" content="' . esc_url($image) . '" />' . "\n";

            // Ajouter le texte alt depuis l'image mise en avant
            $thumbnail_id = get_post_thumbnail_id($post->ID);
            $alt_text = get_post_meta($thumbnail_id, '_wp_attachment_image_alt', true);
            if ($alt_text) {
                echo '<meta name="twitter:image:alt" content="' . esc_attr($alt_text) . '" />' . "\n";
            }
        }

        // Pseudonyme Twitter du site
        echo '<meta name="twitter:site" content="@VotrePseudoSite" />' . "\n";

        // Pseudonyme Twitter de l'auteur (s'il est défini)
        if ($author_twitter) {
            echo '<meta name="twitter:creator" content="@' . esc_attr($author_twitter) . '" />' . "\n";
        }

    } elseif (is_front_page()) {
        echo '<meta name="twitter:card" content="summary_large_image" />' . "\n";
        echo '<meta name="twitter:title" content="' . esc_attr(get_bloginfo('name')) . '" />' . "\n";
        echo '<meta name="twitter:description" content="' . esc_attr(get_bloginfo('description')) . '" />' . "\n";
        echo '<meta name="twitter:site" content="@VotrePseudoSite" />' . "\n";
    }
}
add_action('wp_head', 'custom_twitter_cards');

Remplacez @VotrePseudoSite par votre nom d'utilisateur X réel. Pour stocker les pseudonymes Twitter des auteurs, vous pouvez ajouter un champ méta utilisateur personnalisé appelé twitter à chaque profil utilisateur, ou utiliser une extension comme « Extra User Details » pour ajouter le champ à l'écran d'édition de profil.

Bonnes pratiques et spécifications d'image pour Twitter Card

L'image est l'élément le plus important d'une Twitter Card. La réussir fait une différence significative en matière d'engagement :

  • Summary Card with Large Image : Utilisez des images avec un ratio d'aspect 2:1. La taille recommandée est de 1200 x 628 pixels. Le minimum est de 300 x 157 pixels, mais des images plus grandes paraissent nettement meilleures, en particulier sur les écrans haute résolution.
  • Summary Card : Utilisez des images carrées avec un ratio d'aspect 1:1. La taille recommandée est de 400 x 400 pixels. Le minimum est de 144 x 144 pixels.
  • Format de fichier : JPG, PNG, WEBP et GIF sont pris en charge. JPG est le choix le plus sûr pour les photographies. PNG fonctionne mieux pour les images avec du texte ou des zones transparentes (bien que la transparence soit composée sur un fond blanc).
  • Taille du fichier : Gardez les images sous 5 Mo. Les fichiers plus volumineux peuvent ne pas se charger ou être ignorés par le processeur de cartes.
  • Évitez les images riches en texte : X recadre les images différemment sur mobile et bureau. Le texte sur les bords d'une image peut être coupé. Gardez le contenu important centré.
  • Utilisez des images uniques par article : Ne réutilisez pas la même image pour chaque article. Des visuels uniques aident votre contenu à se démarquer et empêchent vos tweets de paraître répétitifs.

Comment les Twitter Cards interagissent avec les balises Open Graph

X utilise une hiérarchie de repli spécifique pour décider quoi afficher dans un aperçu de carte :

  1. D'abord, il vérifie les balises meta twitter:* explicites.
  2. Si une balise twitter:* est manquante, il se rabat sur la balise Open Graph équivalente (og:title, og:description, og:image).
  3. Si les deux sont manquantes, il utilise la balise <title> de la page et tente d'extraire une description du contenu.

Cela signifie que vous n'avez pas strictement besoin des deux ensembles de balises. Si vos balises Open Graph sont déjà configurées (pour le partage Facebook, par exemple), les aperçus Twitter Card de base fonctionneront. Cependant, il y a des cas où vous voulez un contenu différent sur différentes plateformes. Par exemple, vous pourriez utiliser une image en paysage pour X mais une image carrée pour Facebook. Dans ce scénario, définir og:image et twitter:image sur des URL différentes vous donne un contrôle spécifique à la plateforme.

La balise twitter:card n'a pas d'équivalent Open Graph, vous devez donc toujours l'inclure explicitement pour définir le type de carte. Sans elle, X n'affichera aucune carte du tout, même si toutes les autres balises sont présentes.

Tester et déboguer vos Twitter Cards

Après avoir ajouté les balises, vérifiez que tout fonctionne correctement :

  1. Vérifiez les balises meta avec InspectWP : Faites passer votre URL dans InspectWP pour vérifier que toutes les balises meta Twitter Card sont présentes dans le code source de la page. InspectWP listera chaque balise meta qu'il trouve, vous permettant de confirmer que les bonnes valeurs sont émises.
  2. Testez directement sur X : Postez un lien dans un tweet (vous pouvez le supprimer immédiatement après). L'aperçu de la carte dans le compositeur de tweet vous montre exactement comment votre lien apparaîtra. Si la carte ne s'affiche pas, attendez une minute et réessayez. X peut prendre un peu de temps pour récupérer et mettre en cache les données de carte pour les nouvelles URL.
  3. Forcer le rafraîchissement du cache : X met en cache les données de carte de manière agressive. Si vous avez mis à jour vos balises mais voyez toujours d'anciennes données, ajoutez un paramètre de requête comme ?v=2 à votre URL. Cela force X à la traiter comme une nouvelle URL et à récupérer à nouveau les informations de la carte.
  4. Vérifiez les problèmes HTTPS : Toutes les URL d'image dans les balises Twitter Card doivent utiliser HTTPS. Les URL d'image HTTP seront bloquées et la carte sera affichée sans image.
  5. Validez les dimensions de l'image : Si votre carte affiche une petite vignette au lieu de l'aperçu en grande image, votre image est probablement plus petite que les dimensions minimales. Vérifiez le ratio d'aspect et la taille en pixels.

Problèmes courants des Twitter Cards et solutions

  • La carte ne s'affiche pas du tout : Assurez-vous que la balise meta twitter:card est présente. Cette balise est obligatoire. Sans elle, X ignore toutes les autres balises meta twitter. Vérifiez également que votre page est accessible publiquement et n'est pas bloquée par un mur de connexion, une protection par mot de passe ou robots.txt.
  • Mauvaise image affichée : X met en cache les données de carte, donc les images récemment modifiées peuvent ne pas se mettre à jour immédiatement. Utilisez un paramètre de requête de contournement de cache sur l'URL pour forcer un rafraîchissement. Vérifiez également que la balise twitter:image pointe vers l'URL correcte et accessible publiquement.
  • Image trop petite ou mal recadrée : Utilisez des images qui répondent aux exigences de taille minimale. Pour les cartes summary_large_image, restez à ou au-dessus de 1200 x 628 pixels. Évitez de placer du contenu important près des bords.
  • Balises meta dupliquées : Si vous utilisez une extension SEO et avez également du code manuel ajoutant des balises Twitter Card, vous vous retrouverez avec des balises dupliquées. X utilise généralement la première qu'il rencontre, mais les doublons peuvent provoquer un comportement imprévisible. Supprimez le code manuel si une extension le gère, ou vice versa.
  • Interférence d'extension de cache : Si vous utilisez une extension de cache de page, videz le cache après avoir mis à jour votre configuration Twitter Card. Sinon, la version mise en cache de vos pages peut toujours contenir les anciennes balises meta (ou manquantes).

Bonnes pratiques pour l'optimisation des Twitter Cards WordPress

  • Par défaut sur summary_large_image : Le format à grande image surpasse systématiquement le format à petite vignette en termes de métriques d'engagement. Utilisez-le pour tous les articles de blog et articles.
  • Rédigez des descriptions convaincantes : Le texte twitter:description est votre argumentaire. Écrivez-le comme un mini-titre qui donne envie aux gens de cliquer. Gardez-le sous 200 caractères et placez les informations les plus importantes en premier.
  • Configurez à la fois les balises OG et Twitter : Même si X se rabat sur les balises OG, avoir les deux ensembles garantit des aperçus cohérents sur toutes les plateformes sociales, y compris Facebook, LinkedIn, Slack et les applications de messagerie.
  • Testez après les mises à jour de thème ou d'extension : Les mises à jour de thème ou d'extension peuvent parfois casser la sortie des balises meta. Après les mises à jour majeures, lancez une analyse rapide d'InspectWP pour vérifier que vos Twitter Cards fonctionnent toujours correctement.
  • Utilisez une image de repli par défaut : Configurez une image par défaut à l'échelle du site dans les paramètres de votre extension SEO. Cela garantit que même les pages sans image mise en avant affichent toujours un visuel de marque dans la Twitter Card, comme votre logo ou un graphique de marque générique.

Vérifiez votre site WordPress dès maintenant

InspectWP analyse votre site WordPress pour détecter les problèmes de sécurité, de SEO, de conformité RGPD et de performance — gratuitement.

Analyser votre site gratuitement