Comment vérifier que vos codes hreflang sont valides ?
- Format strict : langue (ISO 639-1, 2 lettres) + éventuellement un tiret et le pays (ISO 3166-1 Alpha 2). Ex. : fr, en-GB.
- Interdit : le code pays seul. Le premier code est toujours la langue, jamais le pays.
- Les codes non standard (ex. es-419) ne sont pas reconnus : la moindre erreur fait ignorer la déclaration.
Une seule lettre mal placée, et tout votre hreflang part à la poubelle. Les codes de langue et de pays obéissent à un format strict : si Google ne les reconnaît pas, il ignore la déclaration — comme si elle n’existait pas. Connaître le bon format évite cette erreur aussi discrète que coûteuse.
Le format exact à respecter
Un code hreflang se compose ainsi : d’abord le code de langue (norme ISO 639-1, deux lettres minuscules : fr, en, es), éventuellement suivi d’un tiret et d’un code de pays (norme ISO 3166-1 Alpha 2 : FR, GB, US). Exemples valides : fr, en-GB, es-MX.
La règle qui surprend : pas de pays seul
Erreur très fréquente : vouloir cibler un pays avec son seul code. C’est interdit. Le premier code est toujours la langue, jamais le pays. Vous ne pouvez pas écrire hreflang="FR" pour « la France » : Google ne devine pas la langue à partir d’un pays. Il faut fr (la langue française) ou fr-FR (français de France).
La langue d’abord, le pays ensuite
Retenez l’ordre : langue puis pays. en-GB signifie « anglais, pour le Royaume-Uni ». L’inverse (GB-en) est invalide. Et le code pays est facultatif : en seul (« anglais, toutes régions ») est parfaitement valide si vous ne ciblez pas un pays précis.
Les codes non supportés
Seuls les codes listés dans les deux normes officielles sont acceptés. Des codes « inventés » ou régionaux non standardisés, comme es-419 (espagnol d’Amérique latine), ne sont pas reconnus par Google et invalident la déclaration. Tenez-vous-en aux codes officiels.
Les erreurs classiques
Les fautes les plus courantes : écrire un pays seul (UK au lieu de en-GB — d’ailleurs le code du Royaume-Uni est GB, pas UK), inverser langue et pays, utiliser un code inexistant, ou une faute de frappe. Chacune suffit à faire ignorer la balise.
Une casse à connaître
Par convention, on écrit la langue en minuscules et le pays en majuscules (fr-FR), mais Google tolère aussi le tout-minuscules (fr-fr). L’essentiel est la justesse des codes, pas la casse. Restez simplement cohérent sur tout votre site.
Comment repérer et corriger
- Limpi signale les codes hreflang invalides ou mal formés sur vos pages.
- Le rapport « Ciblage international » de la Search Console signale aussi les codes inconnus.
- Corrigez au bon format : langue (ISO 639-1) + tiret + pays (ISO 3166-1 Alpha 2), jamais le pays seul.
Respectez le format : langue en deux lettres, éventuellement un tiret et le code pays. Jamais de pays seul, jamais de code inventé. Une seule erreur fait ignorer toute la déclaration de la page.
Un code hreflang mal formé, c’est une adresse postale avec un code postal inventé : la lettre ne sera pas refusée poliment, elle sera simplement jetée.
Le cas particulier des écritures multiples
Une subtilité, rare mais utile à connaître : quelques langues s’écrivent dans plusieurs systèmes d’écriture. Le chinois, par exemple, se décline en caractères simplifiés et traditionnels. Dans ce cas, on précise le « script » entre la langue et le pays : zh-Hans (chinois simplifié) ou zh-Hant (chinois traditionnel), selon une troisième norme (ISO 15924). Pour l’immense majorité des sites — et certainement pour un commerce francophone qui propose au plus du français et de l’anglais — ce raffinement ne vous concerne pas : fr, en, en-GB et consorts suffisent amplement. Ne vous compliquez la vie avec les scripts que si vous ciblez réellement une langue à écritures multiples ; sinon, le couple langue + pays reste la règle simple à suivre.
En résumé
Les codes hreflang suivent un format strict : langue (ISO 639-1, deux lettres) puis, en option, un tiret et le pays (ISO 3166-1 Alpha 2). Jamais de pays seul, jamais de code non standard comme es-419. La moindre erreur fait ignorer la déclaration. Vérifiez vos codes avec Limpi et la Search Console, et corrigez-les au format exact : c’est ce qui sépare un hreflang utile d’un hreflang invisible.
Questions fréquentes
Quel est le format d’un code hreflang ?
La langue en deux lettres (ISO 639-1), éventuellement suivie d’un tiret et du code pays (ISO 3166-1 Alpha 2). Ex. : fr, en-GB, es-MX.
Puis-je cibler un pays avec son seul code ?
Non. Le premier code est toujours la langue. « FR » seul est invalide ; il faut fr (langue) ou fr-FR (français de France).
Dans quel ordre écrire langue et pays ?
Langue d’abord, pays ensuite : en-GB (anglais pour le Royaume-Uni). L’inverse est invalide. Le code pays est facultatif.
Quels codes ne sont pas reconnus ?
Ceux hors des normes officielles, comme es-419. Seuls les codes listés dans ISO 639-1 (langue) et ISO 3166-1 Alpha 2 (pays) sont acceptés.
Comment repérer les erreurs ?
Via Limpi et le rapport « Ciblage international » de la Search Console, qui signalent les codes invalides ou inconnus.
Sources et références
- Google Search Central — Versions localisées de vos pages (hreflang)
- Google Search Central — Gérer les sites multirégionaux et multilingues
Vous voulez savoir ce qu'il en est sur VOTRE site ?
Limpi analyse votre site et vous dit, en clair, ce qui cloche et comment le corriger. Sans jargon.