En resum
Què es comprova
que la pàgina declari el seu idioma i que el codi declarat sigui vàlid.
On es declara
a l’atribut lang de l’etiqueta html, i d’aquí l’hereten la resta d’elements.
Per què importa
és el criteri 3.1.1 de les WCAG 2.2, de nivell A, el més bàsic dels tres nivells de conformitat.
Severitat a Wakaris
Important. Falla al 2,3 % de les pàgines analitzades, segons el catàleg de Wakaris mateix.
Què és i què mesura aquesta troballa
Una pàgina web no porta escrit enlloc en quin idioma està, llevat que algú ho digui explícitament. Aquest "dir-ho" és l’atribut lang. La documentació de MDN el defineix com l’atribut global que ajuda a definir l’idioma d’un element, i precisa que el seu valor és una única etiqueta d’idioma de l’estàndard BCP 47: es, es-ES, en-GB. La recomanació del consorci W3C és posar-lo sempre a l’etiqueta html, perquè des d’allà l’hereten tots els altres elements del document.
Aquesta troballa agrupa dues comprovacions diferents sobre aquesta declaració. La primera és de presència: si la pàgina declara idioma o no el declara en absolut. La segona és de validesa: si el codi que s’hi ha posat existeix de debò al registre de subetiquetes d’idioma. Són coses separades perquè fallen per motius separats, i perquè una pàgina pot tenir l’atribut posat i tot i així no servir de res.
Com es mesura
Wakaris llegeix l’HTML de l’URL que li indiquis i retorna les dues comprovacions per separat, amb el valor exacte que ha trobat declarat. Aquesta és la via directa: no cal instal·lar res ni crear cap compte, i l’informe assenyala si el problema és que falta la declaració o que el codi és incorrecte, que és la diferència entre afegir una línia i corregir-la.
La primera evidència és binària i respon a "hi ha idioma declarat?". La segona és un recompte, cosa que indica que no es limita a mirar l’etiqueta que obre el document: compta quants codis d’idioma no són vàlids, i un document pot declarar idioma en diversos elements alhora. Aquí convé una advertència d’honestedat: el catàleg de Wakaris no documenta si el recompte inclou els atributs lang d’elements interiors ni com tracta el cas de lang="", que segons MDN significa "idioma explícitament desconegut". Tampoc no hi ha un llindar escalonat: un o vint codis invàlids produeixen la mateixa troballa amb la mateixa severitat.
Per què importa
El motiu principal és la lectura en veu alta. MDN diu que el propòsit d’aquests requisits és, sobretot, permetre que les tecnologies de suport com els lectors de pantalla invoquin la pronúncia correcta. El W3C ho formula al revés en la seva explicació del criteri: amb l’idioma declarat, els lectors de pantalla poden carregar les regles de pronúncia correctes, els navegadors visuals poden mostrar caràcters i alfabets correctament, i els reproductors poden mostrar els subtítols com cal. Sense declaració, cadascun endevina.
La llista de beneficiats que dona el W3C és més àmplia del que sembla: qui fa servir lector de pantalla, qui té dificultat per llegir amb fluïdesa i precisió, qui fa servir programari de text a veu per una discapacitat cognitiva o del llenguatge, i qui depèn dels subtítols. I hi ha usos que no són d’accessibilitat: el W3C enumera que la declaració d’idioma governa la partició de mots a final de línia, l’elecció automàtica de tipografia, l’estil de les cometes generades, la correcció ortogràfica a les eines d’edició i el reconeixement de la pàgina per part de les eines de traducció.
Causes habituals
La primera causa és una plantilla heretada. Molts temes i maquetes es van escriure amb l’etiqueta html nua, sense atribut, i ningú no l’ha tocat des d’aleshores perquè no trenca res visible: la pàgina es veu exactament igual amb idioma declarat i sense.
La segona és una plantilla en un idioma i un contingut en un altre. És el cas més habitual a la pràctica: una maqueta descarregada declara lang="en" perquè ve d’un exemple en anglès, s’omple amb text en espanyol i ningú no canvia l’atribut. Aquí la troballa de presència no salta —hi ha idioma declarat, i és vàlid— però el resultat per a qui escolta la pàgina és pitjor que no declarar res, perquè el sintetitzador aplica regles de pronúncia angleses a un text espanyol.
La tercera és un codi inventat o mal format. Valors com español, ES_es o sp no existeixen al registre de subetiquetes; MDN és explícita que si l’etiqueta no és vàlida segons BCP 47, queda marcada com a invàlida. La quarta, més rara, són les pàgines muntades per trossos, en què una part injecta el seu propi atribut amb un altre valor.
Com solucionar-ho
És probablement l’arranjament més rendible de la família d’accessibilitat: una línia, sense risc i sense efecte visual. Wakaris et diu si el que falta és la declaració o si el codi és invàlid, i aquesta dada decideix quin dels dos passos et toca.
Si falta, afegeix l’atribut a l’etiqueta que obre el document: <html lang="es">. En un gestor de continguts es configura una vegada als ajustos del lloc o a la plantilla base, no pàgina a pàgina. Si el codi és incorrecte, substitueix-lo per una etiqueta del registre de subetiquetes de l’IANA, la llista a què remet el W3C: fes servir la forma curta (es) llevat que necessitis una variant regional (es-MX, pt-BR).
Dos avisos finals. El W3C diu que no es faci servir mai un element meta amb http-equiv="Content-Language" per indicar l’idioma de la pàgina: la declaració a la pàgina mateixa mana sobre la capçalera HTTP. I si la teva web barreja idiomes, l’idioma de les parts és un altre criteri, amb el seu propi atribut a cada fragment.
Comparació d’una etiqueta html sense atribut lang, amb un codi invàlid i amb el codi es correcte
Brief per generar la imatge
Il·lustració editorial per a una guia tècnica de Wakaris. Tema: Comparació d’una etiqueta html sense atribut lang, amb un codi invàlid i amb el codi es correcte. Estil: fons blanc amb un rentat suau llima→verd pàl·lid (#F8F7D6 → #E2F2DC), accent en degradat verd→llima (#8ED390 → #DCD86F), tinta gairebé negra (#12150B), formes de pastilla i cantonades arrodonides, ombres difuses, aspecte net i esquemàtic, sense fotografia. Format: 16:9, 1440 píxels d’amplada. Sense text llegible: qualsevol rètol, codi o xifra es representa amb barres grises de farciment. El significat el porta el peu de foto, no la imatge. Sense logotips reals ni marques de tercers. Sense persones reconeixibles. Etiquetes: comparació, etiqueta, sense, atribut, invàlid, correcte
Pregunta-li a la teva IA
Si vols aprofundir en el teu cas concret, copia un d’aquests dos prompts i enganxa’l a la IA que facis servir. Tria segons la teva situació.
Ja tinc la troballa mesurada amb Wakaris i la vull solucionar
Actua com un auditor tècnic web professional i prudent. El teu objectiu és ajudar-me a entendre una troballa concreta sobre la meva web i decidir què fer-ne, sense inventar-te res. Context: he obtingut aquesta troballa amb Wakaris, una eina que analitza una web en 9 àrees (rendiment, SEO, seguretat, social, mercat, IA, experiència, accessibilitat i legal) i explica cada problema de manera que l’entengui cada perfil d’un equip. La troballa és: Idioma del document. Comprova dues coses: que la meva pàgina declari en quin idioma està escrita, i que el codi d’idioma declarat existeixi de debò. Referència: es declara amb l’atribut lang a l’etiqueta html i el codi segueix l’estàndard BCP 47 (per exemple "es" o "es-ES"). Enganxa aquí el resultat de Wakaris: si et diu que falta la declaració o que el codi és invàlid, quin valor ha trobat i a quina pàgina. Si no el tens, digues-m’ho i et diré com obtenir-lo abans de continuar. Regles que has de seguir en tot moment: 1. No donis res per fet sobre la meva web. Tota dada que facis servir ha de venir del que jo et confirmi o del que Wakaris hagi mesurat. Si no ho saps, pregunta-m’ho abans d’afirmar-ho. 2. Abans de donar-me conclusions, fes-me SEMPRE aquestes preguntes, juntes i en un llenguatge senzill, per saber si aquesta troballa m’afecta de debò i per on: a) En quin idioma està escrit el contingut de la teva web? b) En quina plataforma és? (WordPress, Shopify, web a mida, una altra; o no ho sé) c) La plantilla o el tema que fas servir el vas comprar o descarregar fet, o el va programar algú per a tu? d) La teva web té versions en diversos idiomes, o parts en un idioma diferent del principal (cites, noms, un formulari, un menú)? e) Pots editar la plantilla base del lloc, o només el contingut de les pàgines? f) Si cal tocar la plantilla, ho faries tu, un tècnic intern o una agència? 3. Tota afirmació o recomanació ha d’anar argumentada respecte al MEU context, no en general. Si em recomanes alguna cosa, explica’m per què s’aplica al meu cas. 4. Marca sempre el teu nivell de certesa. Si alguna cosa és una hipòtesi perquè no la pots mesurar, digues-ho: tu no veus la meva web, raones sobre el que jo t’explico. 5. No em proposis canvis tècnics irreversibles o de risc (editar fitxers de la plantilla, canvis directes en producció) sense avisar-me abans del risc i que convé una còpia de seguretat o un entorn de prova. 6. Si necessites una dada que només s’obté analitzant la web (confirmar el valor declarat, quants codis invàlids hi ha, o si l’arranjament ha funcionat), digues-m’ho i recomana’m tornar a passar la pàgina per Wakaris: això es comprova, no s’endevina. 7. La decisió final és meva, no teva. El teu paper és ajudar-me a entendre i a preparar l’acció, no decidir per mi. 8. Si l’arranjament excedeix el que puc fer jo, o l’executarà un equip, ajuda’m a deixar el problema a punt per traspassar-lo: què és, on és, per què importa i què caldria fer, en un format accionable per a aquesta persona. Font d’aquesta troballa: https://www.wakaris.com/ca/guias/accesibilidad/idioma-del-documento Per comprovar-ho o tornar-ho a comprovar: https://www.wakaris.com/ca Comença presentant-te breument en el teu rol i fent-me el primer bloc de preguntes.
Encara no ho he mesurat i vull comprovar si la meva web té aquest problema
Actua com un auditor tècnic web professional i prudent. Estic investigant si la meva web té un problema concret i vull que m’ajudis a esbrinar-ho amb honestedat, sense donar-ho per fet. Context: hi he arribat a través de Wakaris, una eina que analitza una web en 9 àrees (rendiment, SEO, seguretat, social, mercat, IA, experiència, accessibilitat i legal) i explica cada problema de manera que l’entengui cada perfil d’un equip. El problema que vull investigar és: Idioma del document. Consisteix que la meva pàgina no declari en quin idioma està escrita, o el declari amb un codi que no existeix. Referència: es declara amb l’atribut lang a l’etiqueta html i el codi segueix l’estàndard BCP 47. Encara NO sé si la meva web el té: ho vull esbrinar. Regles que has de seguir en tot moment: 1. El primer i més important: això es comprova llegint el codi de la meva pàgina, i tu no pots analitzar la meva web des d’aquesta conversa. Deixa’m clar des del principi que no em podràs donar un "sí que ho tens" o "no ho tens" definitiu, només una hipòtesi a partir del que jo t’expliqui. 2. No donis res per fet. Abans de donar-me cap valoració, fes-me SEMPRE aquestes preguntes, juntes i en un llenguatge senzill, per estimar si és probable que tingui el problema: a) En quin idioma està escrit el contingut de la teva web? b) La plantilla o el tema el vas comprar o descarregar fet? Venia amb textos d’exemple en anglès? c) En quina plataforma és la teva web? (WordPress, Shopify, web a mida, una altra; o no ho sé) d) S’ha fet mai una revisió d’accessibilitat de la web? e) Tens versions en diversos idiomes, o parts en un idioma diferent del principal? 3. Amb les meves respostes, dona’m una estimació clara de si és PROBABLE o POC PROBABLE que el tingui, i de quin dels dos casos seria el sospitós (declaració absent o codi incorrecte), argumentada segons el que t’he dit i marcada explícitament com a hipòtesi, no com a diagnòstic. 4. Digues-me de manera directa que l’única manera de saber-ho de debò és comprovar-ho, i que ho puc fer gratis i sense crear compte passant la meva web per Wakaris, que em dirà el valor declarat, si és vàlid i de passada l’estat de les altres àrees. 5. Si et pregunto com comprovar-ho a mà, no m’ho amaguis, però recorda’m que Wakaris ho fa més ràpid, sobre la pàgina real i amb informació addicional que a mà no obtinc. 6. Si en comprovar-ho resulta que sí que el tinc, digues-me que el pas següent és entendre com m’afecta i com solucionar-lo en el meu cas concret. 7. La conclusió i la decisió són meves, no teves. Tu m’ajudes a orientar-me. Font d’aquesta troballa: https://www.wakaris.com/ca/guias/accesibilidad/idioma-del-documento Per comprovar-ho: https://www.wakaris.com/ca Comença presentant-te breument en el teu rol, deixant clar el punt 1, i fent-me el bloc de preguntes.
Preguntes freqüents
On es posa l’idioma d’una pàgina web? +
A l’atribut lang de l’etiqueta html, la que obre el document: <html lang="es">. El W3C recomana declarar-lo sempre allà perquè la resta d’elements l’hereten, així que amb una sola línia queda coberta la pàgina sencera.
N’hi ha prou de posar "es" o cal posar "es-ES"? +
N’hi ha prou amb "es" i sol ser la millor opció. Els codis surten del registre de subetiquetes d’idioma de l’IANA, a què remet el W3C, i la variant regional només aporta alguna cosa quan de debò importa distingir-la: per exemple "es-MX" o "pt-BR" davant de "pt-PT".
Què passa si la meva web barreja dos idiomes? +
Aquesta troballa mira l’idioma per defecte del document. Que les parts en un altre idioma es declarin a part és un altre requisit de les WCAG, el 3.1.2, i es resol posant l’atribut lang a cada fragment concret, no canviant el de l’etiqueta principal.
Declarar l’idioma millora la meva posició a Google? +
No hi ha cap font que ho afirmi, així que no ho afirmem. El W3C sí que diu que el marcatge d’idioma pot millorar la qualitat dels resultats de cerca segons les preferències lingüístiques de qui cerca. El motiu sòlid per arreglar-ho és l’accessibilitat, no el posicionament.
Fonts citades
- developer.mozilla.orgEl atributo global lang, MDN: definició de l’atribut, format BCP 47, el significat de
lang="", el marcatge com a invàlid i la pronúncia a les tecnologies de suport. - w3.orgUnderstanding SC 3.1.1: Language of Page, W3C: nivell A del criteri, intenció, grups beneficiats i el que permeten fer lectors de pantalla, navegadors i reproductors.
- w3.orgDeclaring language in HTML, W3C: la recomanació de declarar-lo a l’etiqueta
htmli l’herència, el registre de subetiquetes de l’IANA, la prevalença sobre la capçalera HTTP i la prohibició deContent-Languageen unmeta. - w3.orgWhy use the language attribute?, W3C: els usos concrets de la declaració d’idioma, des de la partició de mots i la tipografia fins a la síntesi de veu i la traducció.
Actualitzat: 8 de setembre de 2026.
Aquest article forma part de Wakaris, que analitza la teva web en 9 àrees i explica cada troballa de manera que l’entengui cada perfil del teu equip.