Générer les balises hreflang de vos versions

Comment utiliser l’outil

Écrivez une ligne par version d’une même page : le code de langue (fr, en, fr-BE...), un séparateur, puis l’adresse complète de cette version. Séparez les groupes de pages équivalentes par une ligne vide : une page produit et ses traductions forment un groupe, la page « à propos » et ses traductions en forment un autre. Un clic sur « Générer les balises » affiche les constats, puis trois sorties à copier ou à télécharger.

Le bouton « Charger un exemple » remplit deux groupes de quatre et trois versions, avec une balise x-default, pour voir le résultat. Chaque groupe produit un seul bloc : le même doit figurer sur toutes les pages du groupe, y compris sur chaque version pour elle-même.¹

Ce que l’outil écrit

Google accepte trois emplacements, qu’il traite de la même façon : le head HTML, les en-têtes HTTP et le sitemap XML. Il n’y a aucun avantage à les cumuler, et la maintenance devient plus lourde : choisissez-en un.¹ L’outil écrit les trois pour que vous gardiez celui qui convient à votre site.

Les balises du head sont des éléments link, un par version. Les en-têtes servent surtout aux fichiers qui n’ont pas de head, comme les PDF : l’adresse est entre chevrons, les éléments sont séparés par une virgule.¹ Dans le sitemap, chaque page est une entrée url avec son loc et un élément xhtml:link par version, ce qui demande l’espace de noms xhtml.¹ Les valeurs spéciales des adresses (&, par exemple) sont échappées pour le HTML et le XML.

<link rel="alternate" hreflang="fr" href="https://www.exemple.fr/chaussures/" />
<link rel="alternate" hreflang="en" href="https://www.exemple.fr/en/shoes/" />
<link rel="alternate" hreflang="x-default" href="https://www.exemple.fr/chaussures/" />

Link: <https://www.exemple.fr/guide.pdf>; rel="alternate"; hreflang="fr",
      <https://www.exemple.fr/en/guide.pdf>; rel="alternate"; hreflang="en"

Ce que l’outil contrôle

Google demande que chaque version se cite elle-même et cite toutes les autres. Si la page X désigne Y, Y doit désigner X, sinon les annotations peuvent être ignorées.¹ L’outil construit chaque bloc à partir de l’ensemble du groupe : les retours sont croisés par construction, et le constat vert vous le rappelle. Il refuse en revanche de mettre la même adresse dans deux groupes, car la page recevrait deux blocs différents.

Il contrôle ensuite les adresses : elles doivent être complètes, avec le protocole, et une adresse comme /page ou //hote/page ne convient pas.¹ Il écarte aussi les adresses avec espace, guillemet, chevron ou fragment, qui casseraient une balise ou un en-tête. Un même code ne peut désigner qu’une adresse par groupe : la première ligne est gardée, la suivante est signalée. Une ligne en double exact est fusionnée, et un groupe d’une seule version est ignoré.

Les codes de langue et de région

Le code commence par une langue ISO 639-1, suivie au besoin d’une écriture ISO 15924 (zh-Hant) et d’une région ISO 3166-1 alpha 2 (en-GB). La casse n’a pas d’importance pour Google, mais la région s’écrit en majuscules par convention : l’outil réécrit fr-be en fr-BE.¹

Plusieurs erreurs fréquentes sont repérées. Un code de pays seul ne désigne pas une langue : « be » désigne le biélorusse, et pour la Belgique il faut écrire nl-BE, fr-BE ou de-BE. Des codes comme es-419 sont refusés, et les codes réservés comme UK ou EU sont ignorés.¹ Le tiret bas (fr_FR) n’est pas valable non plus. La validation utilise la même méthode que le testeur hreflang, fondée sur les données de langues et de pays du navigateur.

La valeur x-default

x-default est une valeur réservée : elle désigne la page de repli quand aucune langue ni région ne correspond au navigateur du visiteur. Google la suggère, notamment pour un sélecteur de langue ou de pays, ou pour une page d’accueil qui redirige selon la langue. Elle n’est pas obligatoire.¹

Cochez l’option pour que l’outil ajoute la ligne à chaque groupe. Il reprend par défaut la première version du groupe ; indiquez un code (en, par exemple) pour en choisir une autre. Si votre page de repli est une page distincte, un sélecteur de langue par exemple, saisissez-la comme une ligne x-default : elle recevra son propre bloc dans le sitemap.

Les limites de l’outil

L’outil ne visite aucune page : il met en forme ce que vous saisissez. Il ne sait donc pas si les adresses répondent, si une redirection les déplace ou si leur balise canonique pointe ailleurs. Google précise aussi que des versions dont seul le gabarit est traduit, avec un contenu principal inchangé, peuvent être vues comme des doublons.¹

La même adresse sous deux codes (en et en-GB, par exemple) est signalée, la documentation de Google ne traitant pas ce cas. Le sitemap généré ne doit contenir que des adresses situées dans le dossier où il est hébergé, ou dans ses sous-dossiers.¹

Après la génération

Une fois les balises en place, passez une page dans le testeur hreflang : il lit les alternatives en ligne et vérifie leurs codes de retour et leurs canoniques. Si vous avez choisi le sitemap, le validateur de sitemap XML contrôle le fichier. Pour décider de l’architecture avant de baliser, le consultant SEO peut vous accompagner.

Questions fréquentes