Outil de diagnostic

Vérificateur hreflang

Saisissez une URL pour lire toutes les annotations hreflang de la page, contrôler chaque code de langue et de région, et récupérer les versions alternatives pour confirmer qu'elles renvoient bien vers elle.

Notre serveur récupère la page que vous saisissez et jusqu'à 10 de ses URL alternatives, puis les transmet à votre navigateur, où les vérifications s'exécutent. Rien n'est stocké.

Comment fonctionne le vérificateur hreflang

Google lit les annotations hreflang à trois endroits : les éléments link dans le head HTML, l'en-tête de réponse HTTP Link et le sitemap XML. Ce vérificateur récupère la page que vous saisissez et lit les deux premiers. Pour la méthode sitemap, cherchez les entrées xhtml:link dans votre fichier sitemap.

Chaque valeur est confrontée au format documenté par Google : un code de langue, suivi d'un code d'écriture facultatif et d'un code de région facultatif, ou la valeur réservée x-default. Chaque URL doit être complète, et les éléments link HTML doivent se trouver dans le head.

Le vérificateur récupère ensuite jusqu'à 10 des URL alternatives citées par la page et lit aussi leurs annotations. Google indique que chaque version linguistique doit se lister elle-même ainsi que toutes les autres versions, et que si deux pages ne pointent pas l'une vers l'autre, les balises sont ignorées. Ce lien retour est la vérification que la plupart des outils omettent.

Les règles hreflang en bref

Chaque règle ci-dessous reprend ce que dit la page de Google Search Central sur les versions localisées, et chacune correspond à une vérification de l'outil.

Code de langueISO 639-1, par exemple en, de ou ja. Indiquer seulement la région n'est pas valide.
Code de régionFacultatif, ISO 3166-1 alpha-2, par exemple GB ou MX. Les codes hors norme, comme es-419, ne sont pas acceptés. EU, UN et UK n'ont aucun effet.
ÉcritureFacultatif, ISO 15924, par exemple zh-Hant pour le chinois traditionnel ou zh-Hans pour le chinois simplifié.
CasseLes valeurs ne sont pas sensibles à la casse : en-gb et en-GB veulent dire la même chose.
x-defaultUne valeur réservée pour le cas où aucune autre langue ni région ne correspond au paramètre du navigateur de l'utilisateur. Conçue pour les pages de sélection de langue.
Auto-référenceChaque version se liste elle-même ainsi que toutes les autres versions.
Liens retourSi la page X renvoie vers la page Y, la page Y doit renvoyer vers la page X. Sinon, les annotations peuvent être ignorées.
URLComplètes, avec http ou https. Ni //example.com/foo ni /foo. Les versions alternatives n'ont pas besoin d'être sur le même domaine.
EmplacementEn HTML, les éléments link doivent se trouver dans une section head bien formée.

Règles vérifiées d'après la documentation de Google : Tell Google about localized versions of your page

Ce que signale le vérificateur

  • Toutes les annotations hreflang de la page, issues du head HTML et de l'en-tête HTTP Link
  • Les codes de langue hors ISO 639-1, les codes de région hors ISO 3166-1 alpha-2, une région employée seule et les codes réservés EU, UN et UK
  • Les URL relatives ou relatives au protocole, que Google n'accepte pas
  • L'absence d'auto-référence, quand aucune annotation ne pointe vers la page vérifiée
  • Un même code listé plusieurs fois, et les éléments link placés hors du head
  • Pour 10 versions alternatives au maximum : si chacune renvoie vers la page, si elle redirige ou renvoie une erreur, et si son jeu d'annotations correspond à celui de cette page

Erreurs hreflang qui plombent le SEO international

Les dix erreurs derrière presque toutes les configurations hreflang cassées, avec le symptôme et la correction de chacune.

Lire le guide hreflang

Sur le blog

Tous les guides →

Frequently asked questions

Que teste un vérificateur hreflang ?
Il lit les annotations hreflang d'une page et les confronte aux règles de Google : codes de langue ISO 639-1 et de région ISO 3166-1 alpha-2 valides, URL complètes, une auto-référence et des liens retour depuis chaque version alternative. Celui-ci signale aussi les codes en double et les éléments link hors du head.
en-UK est-il une valeur hreflang valide ?
Non. Le code de région du Royaume-Uni dans ISO 3166-1 alpha-2 est GB : écrivez donc en-GB. Google cite UK, avec EU et UN, parmi les codes sans effet dans les annotations hreflang. La partie langue compte toujours, mais la partie région ne sert à rien.
Ai-je besoin de x-default ?
Google ne l'exige pas. La valeur réservée x-default indique à Google quelle page utiliser quand aucune autre langue ni région ne correspond au paramètre du navigateur de l'utilisateur. Elle a été conçue pour les pages de sélection de langue, mais vous pouvez l'utiliser sur n'importe quelle page. Le vérificateur signale son absence.
Pourquoi le vérificateur récupère-t-il les autres pages ?
Parce que hreflang ne fonctionne que par paires. Google indique que si deux pages ne pointent pas l'une vers l'autre, les balises sont ignorées. Le seul moyen de le confirmer est d'ouvrir chaque version alternative et de lire ses annotations : c'est exactement ce que fait le vérificateur, pour 10 d'entre elles au maximum.
hreflang indique-t-il à Google la langue de ma page ?
Non. Google indique qu'il n'utilise ni hreflang ni l'attribut lang du HTML pour détecter la langue d'une page ; il s'appuie sur ses propres algorithmes. hreflang indique à Google quelles autres versions de la page existent et à qui chacune s'adresse.