Sobre o atributo lang do HTML
O que é o atributo lang do HTML?
O atributo lang do HTML encontra-se na etiqueta html de abertura e declara em que idioma a página está escrita. É um único atributo curto e é um dos elementos de marcação mais frequentemente omitidos na Web.
Ao contrário de hreflang, que descreve relações entre páginas, lang descreve apenas esta página. Os dois funcionam em conjunto, mas respondem a perguntas diferentes: lang indica em que idioma está a ler, enquanto hreflang indica onde se encontram as outras versões.
Não custa nada e demora apenas alguns segundos, razão pela qual uma verificação falhada do atributo lang do HTML é geralmente sinal de que ninguém analisou o elemento head do modelo, e não de uma decisão ponderada.
O atributo lang ainda é importante em 2026?
É sobretudo importante para a acessibilidade, e essa não é uma preocupação marginal. Os leitores de ecrã utilizam-no para escolher as regras de pronúncia, e uma página que declare o idioma errado, ou que não declare nenhum, pode ser lida em voz alta com um sotaque que a torne verdadeiramente incompreensível.
Os navegadores também o utilizam: para disponibilizar traduções, para a hifenização, para a verificação ortográfica nos campos de formulário e para escolher o tipo de letra adequado quando estão envolvidos vários sistemas de escrita. Esses efeitos são visíveis para os visitantes comuns, que nunca pensariam em consultar o código.
É também uma consideração jurídica num número crescente de jurisdições, onde as normas de acessibilidade que fazem referência à declaração do idioma são cada vez mais aplicadas, em vez de serem apenas publicadas.
Como o atributo lang se relaciona com a pesquisa com IA
A deteção do idioma a partir do texto é fiável no caso de documentos longos e muito menos fiável no caso de textos curtos, páginas com muitos nomes de produtos ou código, ou conteúdos que misturam vários idiomas. Uma declaração explícita elimina completamente essa incerteza.
Para um modelo que está a compor uma resposta num determinado idioma, saber que uma fonte é considerada fidedigna nesse idioma constitui um filtro relevante. Uma página cujo idioma foi detetado incorretamente é excluída das respostas às quais deveria pertencer ou incluída em respostas às quais não pertence.
As páginas com muito vocabulário técnico não traduzido são as que são classificadas incorretamente com maior frequência e também aquelas em que ser identificadas corretamente é mais importante.
Boas práticas para o atributo lang
- Declare-o em todas as páginas, na tag html de abertura.
- Utilize o idioma em que o conteúdo do corpo da página está efetivamente escrito, não o idioma da sua interface de administração.
- Adicione um subtítulo regional apenas quando este alterar o conteúdo, como no caso das convenções ortográficas regionais.
- Identifique inline os trechos escritos noutro idioma, para que as páginas com vários idiomas continuem a ser lidas corretamente.
- Mantenha-o consistente com quaisquer anotações hreflang existentes na mesma página.
- Verifique individualmente as páginas traduzidas; os modelos declaram frequentemente o idioma original em todas as variantes.
O que esta ferramenta verifica
A ferramenta indica se a página declara um atributo de idioma no elemento html. Não verifica se o idioma declarado corresponde ao conteúdo, pelo que uma página escrita em francês, mas que se declara em inglês, continuará a passar.
É importante ter esta limitação em conta em sites traduzidos, onde o erro mais comum não é a ausência do atributo, mas sim a repetição do mesmo atributo em todas as versões linguísticas.
Próximos passos
A indicação do idioma é uma das formas de informar os motores de pesquisa a quem se destina uma página. Se publicar em mais do que um idioma, verifique as anotações
verificador de hreflang que ligam as suas versões e confirme se a indicação
verificador de etiquetas canónicas aponta para a variante correta, em vez de apontar para outra versão linguística.