Mode d'emploi
- Saisissez une ligne par version linguistique dans Versions linguistiques : le code, une barre verticale et l'adresse complète.
- Si vous avez un sélecteur de langue ou une page par défaut, saisissez son adresse dans Adresse de repli (x-default).
- Lisez Contrôle des lignes. Quand il indique que toutes les versions sont valides, copiez les éléments link, le plan de site ou l'en-tête.
- Mettez le même ensemble sur chaque page, et vérifiez que chaque version renvoie vers toutes les autres.
Comment les codes sont vérifiés
La partie langue doit être un code à deux lettres de l'ISO 639-1 : la liste de la Library of Congress en compte 183. La région facultative doit être un code ISO 3166-1 alpha-2 attribué officiellement, comme GB ou TW. Le guide de Google indique que seules ces deux normes sont prises en charge et que la langue vient en premier, si bien qu'une région seule, comme GB, est refusée.
Une partie script, comme Hant ou Hans, doit comporter quatre lettres. Le guide de Google indique que les scripts sont donnés selon l'ISO 15924 ; cet outil vérifie la forme du script, et non la liste complète. Les codes ne tiennent pas compte de la casse : l'outil écrit donc la langue en minuscules, la région en majuscules et le script avec une majuscule initiale.
- en-uk est refusé, car UK est un code réservé ; le Royaume-Uni a pour code GB, et l'outil propose donc en-GB.
- iw, in et ji ont été remplacés en 1989 par he, id et yi, et l'outil propose ces codes.
- Les codes qui ne correspondent à rien, comme xx, eng ou en_US, sont refusés avec leur numéro de ligne.
Trois façons d'envoyer le même ensemble
Google donne trois méthodes : les éléments link dans l'en-tête HTML, les en-têtes HTTP et un plan de site XML. Google indique que les trois sont équivalentes ; choisissez donc celle qui est la plus facile à tenir à jour. La forme en plan de site demande l'espace de noms xhtml, et chaque entrée url liste toutes les alternatives, y compris elle-même.
La méthode d'en-tête HTTP est décrite pour la réponse GET de toute page ; Google la juge utile pour les fichiers qui ne sont pas en HTML, comme les PDF, et ses exemples sont des PDF. Pour une page web, les éléments link ou le plan de site sont le choix habituel. Google indique aussi que l'en-tête Link renvoyé pour chaque version d'une page est identique : cet outil écrit donc une seule valeur pour tout l'ensemble.
Liens de retour et x-default
Chaque version doit se lister elle-même et lister toutes les autres, et chaque page doit renvoyer vers les autres. Google indique : « Si deux pages ne renvoient pas toutes les deux l'une vers l'autre, les balises seront ignorées. » Lorsqu'un ensemble est difficile à garder complet, Google admet qu'on omette certaines langues sur certaines pages, et il traite toujours les paires qui renvoient l'une vers l'autre.
x-default désigne la page de repli pour les langues qui ne correspondent à aucune de vos versions. Google le recommande pour les pages de sélection de langue, et il s'écrit sans code de langue.
Exemple : trois versions et un repli
Les lignes en | https://example.com/en/, en-GB | https://example.com/en-gb/ et tr | https://example.com/tr/, avec https://example.com/ comme repli, font quatre alternatives. Chaque page de l'ensemble reçoit les mêmes quatre éléments link, et le plan de site contient une entrée url pour chacune des trois pages.
Chaque entrée url liste les quatre alternatives. La ligne d'état indique 3 versions linguistiques, toutes valides, car le repli n'est pas une version linguistique.
| Sortie | Nombre | Détail |
|---|---|---|
| Éléments link | 4 | hreflang="tr" href="https://example.com/tr/" |
| Entrées url du plan de site | 3 | chacune liste 4 alternatives, x-default compris |
| Valeurs de l'en-tête Link | 1 | la même valeur sur chaque page, avec 4 alternatives |
| Versions linguistiques | 3 | état : 3 versions linguistiques, toutes valides |
Questions fréquentes
Quels codes sont valides ?
Un code de langue de l'ISO 639-1, comme en, tr ou zh, peut être suivi d'un script à quatre lettres, comme Hant, et d'une région de l'ISO 3166-1, comme GB ou TW. Les codes ne tiennent pas compte de la casse, et l'outil les écrit selon la forme usuelle.
Pourquoi en-uk est-il signalé comme une erreur ?
UK est un code réservé dans l'ISO 3166-1, et le guide de Google indique que UK n'a aucun effet dans hreflang. Le code attribué au Royaume-Uni est GB, donc la balise correcte est en-GB.
Ai-je besoin d'une ligne x-default ?
Elle est facultative. Google appelle x-default le repli pour les langues qui ne correspondent à aucune de vos versions, et le recommande pour les sélecteurs de langue. L'outil ne l'ajoute que si vous saisissez une adresse.
Chaque page doit-elle lister tout l'ensemble ?
Chaque version doit se lister elle-même et lister toutes les autres. Google indique que les balises sont ignorées lorsque deux pages ne renvoient pas l'une vers l'autre, mais il admet aussi qu'on omette une langue sur certaines pages, et il traitera toujours les paires qui renvoient l'une vers l'autre.
Pourquoi l'outil n'accepte-t-il que les adresses https ?
Il accepte les adresses https absolues, que la plupart des sites utilisent aujourd'hui. Google demande des adresses complètes qui incluent le protocole ; un site qui fonctionne encore en http simple doit donc écrire ses annotations à la main.
La méthode d'en-tête HTTP est-elle prévue pour les pages web ?
Google la décrit pour la réponse GET de toute page et la juge utile pour les fichiers qui ne sont pas en HTML, comme les PDF. Pour les pages web, les éléments link ou le plan de site sont le choix habituel.
L'outil envoie-t-il mes adresses quelque part ?
Non. Le résultat est construit dans votre navigateur à partir du texte que vous saisissez, et rien n'est envoyé à un serveur.
Sources
- Google Search Central : localized versions and hreflang (en anglais)
- Library of Congress : ISO 639-2 code list with the ISO 639-1 codes (en anglais)
- Wikipédia (en anglais) : ISO 639-1 (183 registered codes)
- Wikipédia (en anglais) : List of ISO 639 language codes (codes changed in 1989)
- Wikipédia (en anglais) : ISO 3166-1 alpha-2 (officially assigned codes; UK is reserved)
- Sitemaps.org : protocol, entity escaping (en anglais)
Chiffres et texte vérifiés pour la dernière fois le mardi 10 novembre 2026.