Technique11 min de lecture

Balise hreflang — guide complet

Format, cluster bidirectionnel, codes ISO, validation. Le débug hreflang qui sauve la SEO internationale.

TL;DR

hreflang indique à Google la langue et zone cible d'une page. Format ISO standard (fr, fr-FR, en-US). Trois emplacements : head HTML, Link header, sitemap XML. Règles d'or : cluster bidirectionnel (A→B et B→A), self-référencement obligatoire, x-default recommandé. Débug via Search Console > Internationalisation.

Par Mattis Bétourné, fondateur d'Yvarn

Cet article s'adresse aux développeurs et SEO managers qui gèrent un site multilingue ou international et veulent éviter les pièges hreflang.

1. Hreflang en bref

L'attribut hreflang, introduit par Google en décembre 2011, indique au moteur de recherche la langue et la zone géographique cible d'une page. Deux usages principaux :

  • Éviter le contenu dupliqué entre versions linguistiques d'un même site (yvarn.fr vs yvarn.com/en).
  • Servir la bonne version à chaque utilisateur selon sa langue et son pays. Un utilisateur français reçoit la version fr-FR, un canadien la version fr-CA, etc.

Sans hreflang correct, Google peut servir une version arbitraire ou même considérer les pages comme dupliquées et n'en indexer qu'une seule. Sur un site international, c'est potentiellement -50 % de trafic.

2. Format et codes

Format obligatoire : [langue] ou [langue]-[pays].

  • Langue : code ISO 639-1 sur 2 lettres minuscules. Exemples : fr, en, de, es.
  • Pays (optionnel) : code ISO 3166-1 alpha-2 sur 2 lettres majuscules. Exemples : FR, US, CA, MX.
  • Séparateur : tiret (-), jamais underscore.

Exemples corrects : fr (français toute zone), fr-FR (français France), fr-CA (français Canada), en-US, en-GB, es-MX.

Exemples invalides (Google ignore) : FR, fr_FR, fra, francais, fr-france. Toute syntaxe non conforme = balise ignorée.

3. Où placer hreflang

A. Head HTML (recommandé)

Pour sites jusqu'à 50 versions linguistiques. Insérer dans le <head> de chaque page :

<link rel="alternate" hreflang="fr-FR" href="https://yvarn.fr/" /> <link rel="alternate" hreflang="en-US" href="https://yvarn.fr/en/" /> <link rel="alternate" hreflang="x-default" href="https://yvarn.fr/" />

B. Link header HTTP

Pour fichiers non-HTML (PDF, vidéos). Header HTTP servi par le serveur :

Link: <https://yvarn.fr/guide.pdf>; rel="alternate"; hreflang="fr-FR", <https://yvarn.fr/en/guide.pdf>; rel="alternate"; hreflang="en-US"

C. Sitemap XML (gros sites)

Pour très gros sites > 50 versions × pays. Déclaration sitemap centralisée via xhtml:link. Plus maintenable que des centaines de tags HTML répétés.

4. Cluster bidirectionnel

Règle critique : chaque page doit déclarer hreflang vers elle-même ET vers toutes ses versions alternatives. Si page A liste hreflang vers B mais B n'en liste pas vers A, Google ignore tout le cluster.

Exemple correct pour un site 3 langues (FR, EN, ES) :

  • Page fr liste : hreflang fr (self), hreflang en, hreflang es, hreflang x-default
  • Page en liste : hreflang fr, hreflang en (self), hreflang es, hreflang x-default
  • Page es liste : hreflang fr, hreflang en, hreflang es (self), hreflang x-default

Le self-référencement est obligatoire. Une page qui ne déclare pas hreflang vers elle-même est traitée comme manquante par Google.

5. Débug dans Search Console

Google Search Console > Anciens outils > Ciblage international > rapport hreflang liste les erreurs détectées.

Cinq erreurs typiques et leurs fixes :

  1. Codes langue invalides. Vérifier ISO 639-1 strict.
  2. hreflang pointant vers 404. Audit régulier post-migration ou refonte.
  3. Cluster non bidirectionnel. Outil Aleyda Solis hreflang tester ou crawler Screaming Frog en mode hreflang.
  4. Mélange fr et fr-FR ambigu. Choisir : soit toutes les pages utilisent fr, soit toutes utilisent fr-FR. Pas de mix.
  5. x-default manquant. Ajouter systématiquement pour contrôler le fallback.
Pour aller plus loin

FAQ — hreflang

01C'est quoi la balise hreflang ?
hreflang est un attribut HTML qui indique à Google la langue et la zone géographique cible d'une page. Permet d'éviter le contenu dupliqué entre versions linguistiques d'un même site et de servir la bonne version à chaque utilisateur selon sa localisation.
02Quel format utiliser pour hreflang ?
Format ISO standard : code langue (2 lettres minuscules ISO 639-1) + code pays optionnel (2 lettres majuscules ISO 3166-1 alpha-2). Exemples valides : fr, fr-FR, fr-CA, en, en-US, en-GB, es-MX. Format invalide : FR, fr_FR, fra. Le séparateur est un tiret, pas un underscore.
03Où placer les balises hreflang ?
Trois emplacements possibles : dans le head HTML (recommandé pour les sites < 50 langues), dans les en-têtes HTTP via Link header (pour les PDF et fichiers non-HTML), ou dans le sitemap XML (recommandé pour les très gros sites multilingues > 50 langues × pays).
04Faut-il toujours ajouter x-default ?
Recommandé fortement. x-default indique la version par défaut à servir quand aucune langue de l'utilisateur ne match. Sans x-default, Google peut choisir une version arbitraire. Avec x-default, vous contrôlez le fallback (souvent la version anglaise pour un site international).
05Hreflang fonctionne-t-il en self-référencement ?
Oui, c'est même obligatoire. Chaque page doit lister hreflang vers elle-même ET vers toutes ses versions alternatives. Le cluster doit être bidirectionnel : si A pointe vers B, B doit pointer vers A. Sinon Google ignore tout le cluster.
06Comment débugger hreflang dans GSC ?
Search Console > Internationalisation : Google liste les erreurs hreflang détectées. Cinq erreurs typiques : codes langue invalides, hreflang pointant vers une URL 404, cluster non bidirectionnel, mélange de formats (fr et fr-FR ambigus), x-default manquant. Corriger chaque type séparément.

En résumé

hreflang est une discipline technique exigeante mais bien documentée. Une fois maîtrisée, elle protège la SEO d'un site international. Mal implémentée, elle dilue le ranking et crée du contenu dupliqué.

Pour un site multilingue avec plus de 3 versions, automatiser la génération hreflang via le CMS ou le framework est obligatoire. Maintenir manuellement > 50 hreflang × 3 emplacements = bug garanti.

· audit international

Audit SEO international

Pour les sites multilingues, l'audit Yvarn inclut une vérification hreflang complète : cluster, codes, sitemap, débug GSC.

Découvrir l'audit Yvarn
Mattis Bétourné, fondateur d'Yvarn
Mattis Bétourné

Fondateur d'Yvarn, agence SEO à Bordeaux. À propos.