1001Ferramentas
🌍Validadores

Verificador hreflang vs lang

Checa consistência entre <html lang="..."> e link[hreflang] — devem casar.

Resultado

Quando o lang da página e o hreflang do link discordam

Duas declarações de idioma convivem numa página internacionalizada: o atributo de idioma no elemento raiz, que diz em que língua o conteúdo está, e o hreflang dos links alternativos, que diz para quem cada versão serve. Quando as duas discordam, o buscador recebe informação contraditória e o leitor de tela pode pronunciar o texto com a fonética errada.

Informe os dois valores e a página compara. Ela distingue três situações: idênticos, o caso desejado; idioma base igual com região diferente, que é aviso e não necessariamente erro; e idiomas diferentes, que é inconsistência real. A distinção importa porque português do Brasil e de Portugal, ou inglês americano e britânico, são casos legítimos de divergência de região.

Vale lembrar as regras de forma: o código de idioma vai em minúsculas e o de região em maiúsculas, separados por hífen — a comparação aqui normaliza a caixa, mas ferramentas de validação reclamam. E o hreflang é recíproco: se a página A aponta para a B, a B precisa apontar de volta para a A, ou o buscador ignora o par inteiro.

Perguntas frequentes

A divergência de região é sempre erro?
Não. Uma página em português do Brasil pode legitimamente ter um link alternativo com hreflang de Portugal apontando para a outra versão. O que não pode é o atributo de idioma da própria página divergir do hreflang que a aponta — aí o conteúdo está declarado como uma língua e ofertado como outra.
Preciso do valor genérico de idioma indefinido?
Ele serve para a versão que atende quem não se encaixa em nenhuma das declaradas — normalmente uma página de seleção ou a versão em inglês internacional. Não é obrigatório, mas ajuda quando o site cobre poucos idiomas e recebe visita de muitos lugares.
O atributo de idioma afeta o quê, na prática?
Leitor de tela escolhe a voz e a fonética por ele — texto em português lido com fonética inglesa fica incompreensível. Navegador usa para oferecer tradução e para escolher regras de hifenização. E o buscador o considera junto com outros sinais para decidir a quem mostrar a página.

Ferramentas Relacionadas