En bref. L’attribut HTML lang déclare la langue principale d’un élément et, sur html, la langue par défaut du document.

Définition : L’attribut HTML lang déclare la langue naturelle principale du contenu d’un élément et de ses attributs contenant du texte. Sur l’élément racine html, il définit la langue par défaut du document, dont héritent les éléments descendants sauf s’ils déclarent une autre langue.

Points clés

Le standard HTML du WHATWG exige une étiquette de langue BCP 47 valide ou une valeur vide, qui indique que la langue est inconnue.
Les recommandations du W3C sur la déclaration de langue placent la langue par défaut sur html, ce qui couvre à la fois l’en-tête et le corps du document.
L’explication du critère « Langue de la page » du W3C décrit comment l’identification de la langue permet aux lecteurs d’écran de charger les règles de prononciation appropriées.
Au 17 octobre 2026, la documentation de Google sur les sites multilingues indique que Google détermine la langue d’une page à partir de son contenu visible et ignore à cette fin les informations de langue présentes dans le code, comme lang.

Comment déclarer la langue d’un document ?

Le guide du W3C sur la déclaration de langue en HTML utilise en pour l’anglais et fr pour le français. Ces étiquettes de langue suivent BCP 47, une spécification qui normalise les identifiants de langue.

L’exemple suivant associe la déclaration d’un document en anglais du guide à son exemple de titre de livre en français :

<!doctype html>
<html lang="en">
<head>
  <title>Book title</title>
</head>
<body>
  <p>The title is "<span lang="fr">Le Bon Usage</span>".</p>
</body>
</html>

L’anglais est la langue par défaut du titre et du paragraphe. L’élément span déclare le français pour le titre du livre. Le même guide recommande d’ajouter un élément englobant tel que span lorsque le texte dont la langue doit être déclarée n’est entouré d’aucune balise.

Selon les règles d’héritage du standard HTML, un élément enfant ordinaire sans déclaration de langue hérite de la langue de son parent. Une déclaration s’applique également aux attributs de cet élément qui contiennent du texte. Une valeur explicitement vide, lang="", indique que la langue est inconnue et interrompt l’héritage de la langue.

À quoi sert la langue et comment la vérifier ?

L’explication du critère « Langue de la page » du W3C porte sur le critère de succès 3.1.1 des Règles pour l’accessibilité des contenus Web (Web Content Accessibility Guidelines, WCAG) : les logiciels doivent pouvoir déterminer la langue naturelle par défaut d’une page. Cette explication relie l’identification de la langue à une prononciation correcte par les lecteurs d’écran. Pour une page contenant plusieurs langues, elle retient comme langue par défaut la plus utilisée ; si les langues sont utilisées à parts égales, elle retient la première employée.

La technique H57 du W3C fournit une procédure de vérification concrète : examiner l’élément html du document, confirmer la présence d’un attribut lang et vérifier que sa valeur respecte BCP 47 et correspond à la langue principale de la page. Vérifier uniquement la présence de l’attribut laisse donc une partie de la procédure inachevée. Une étiquette valide doit aussi correspondre au texte réel.

Quel est le lien entre lang, la recherche et les pages traduites ?

Les recommandations de Google sur les sites multilingues distinguent la détection de la langue des annotations destinées aux versions traduites. Elles préconisent une seule langue pour le contenu et la navigation de chaque page, ainsi que des URL distinctes pour les différentes versions linguistiques. Elles présentent hreflang, une annotation qui identifie les variantes linguistiques ou régionales, comme un moyen d’aider la recherche Google à proposer un lien vers la version appropriée.

La technique H57 du W3C place la langue par défaut sur html. Pour les documents traduits, cette déclaration correspond à la langue principale de chaque page.

Termes associés

Questions fréquentes

Puis-je placer lang uniquement sur body ?

Le guide du W3C sur la déclaration de langue recommande html, car une déclaration sur body laisse hors de sa portée le texte de head, y compris le titre du document.

lang peut-il contenir une liste de langues ?

Le standard HTML exige une étiquette BCP 47 valide ou une valeur vide. Déclarez la langue par défaut sur html et utilisez des attributs de langue autour des passages dans une autre langue, conformément aux recommandations du W3C ci-dessus.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Attribut HTML lang