Ferramenta de diagnóstico

Verificador de hreflang

Informe uma URL para ler todas as anotações hreflang da página, conferir cada código de idioma e região e buscar as versões alternativas para confirmar que elas apontam de volta.

Nosso servidor busca a página que você informar e até 10 das URLs alternativas dela e as devolve ao seu navegador, onde as verificações são feitas. Nada é armazenado.

Como o verificador de hreflang funciona

O Google lê as anotações hreflang em três lugares: elementos link no head do HTML, o cabeçalho de resposta HTTP Link e o sitemap XML. Este verificador busca a página que você informar e lê os dois primeiros. Para o método do sitemap, procure as entradas xhtml:link no seu arquivo de sitemap.

Cada valor é conferido com o formato documentado pelo Google: um código de idioma, seguido de um código de escrita opcional e de um código de região opcional, ou o valor reservado x-default. Cada URL precisa ser completa, e os elementos link do HTML precisam estar dentro do head.

Depois, o verificador busca até 10 das URLs alternativas citadas pela página e lê as anotações delas também. O Google diz que cada versão de idioma deve listar a si mesma e todas as outras versões, e que, se duas páginas não apontarem uma para a outra, as tags serão ignoradas. Esse link de retorno é a verificação que a maioria das ferramentas deixa de lado.

As regras do hreflang em resumo

Cada regra abaixo é o que diz a página da Central da Pesquisa Google sobre versões localizadas, e cada uma corresponde a uma verificação da ferramenta.

Código de idiomaISO 639-1, como en, de ou ja. Especificar só a região não é válido.
Código de regiãoOpcional, ISO 3166-1 alpha-2, como GB ou MX. Códigos fora do padrão, como es-419, não são aceitos. EU, UN e UK não têm efeito.
EscritaOpcional, ISO 15924, como zh-Hant para chinês tradicional ou zh-Hans para chinês simplificado.
MaiúsculasOs valores não diferenciam maiúsculas de minúsculas, então en-gb e en-GB significam a mesma coisa.
x-defaultUm valor reservado para quando nenhum outro idioma ou região corresponde à configuração do navegador do usuário. Pensado para páginas de seleção de idioma.
AutorreferênciaCada versão lista a si mesma e todas as outras versões.
Links de retornoSe a página X aponta para a página Y, a página Y precisa apontar de volta para a página X. Sem isso, as anotações podem ser ignoradas.
URLsCompletas, com http ou https. Nem //example.com/foo, nem /foo. As alternativas não precisam estar no mesmo domínio.
PosiçãoNo HTML, os elementos link precisam estar dentro de uma seção head bem formada.

Regras conferidas com a documentação do Google: Tell Google about localized versions of your page

O que o verificador mostra

  • Todas as anotações hreflang da página, do head do HTML e do cabeçalho HTTP Link
  • Códigos de idioma que não são ISO 639-1, códigos de região que não são ISO 3166-1 alpha-2, uma região usada sozinha e os códigos reservados EU, UN e UK
  • URLs relativas ou relativas ao protocolo, que o Google não aceita
  • Autorreferência ausente, quando nenhuma anotação aponta para a página verificada
  • O mesmo código listado mais de uma vez e elementos link colocados fora do head
  • Para até 10 alternativas: se cada uma aponta de volta, se redireciona ou retorna um erro e se o conjunto de anotações dela bate com o desta página

Erros de hreflang que arruínam o SEO internacional

Os dez erros por trás de quase toda configuração de hreflang quebrada, com o sintoma e a correção de cada um.

Ler o guia de hreflang

Do blog

Todos os guias →

Frequently asked questions

O que um verificador de hreflang testa?
Ele lê as anotações hreflang de uma página e as confere com as regras do Google: códigos de idioma ISO 639-1 e de região ISO 3166-1 alpha-2 válidos, URLs completas, uma autorreferência e links de retorno de cada alternativa. Este também aponta códigos duplicados e elementos link fora do head.
en-UK é um valor de hreflang válido?
Não. O código de região do Reino Unido no ISO 3166-1 alpha-2 é GB, então escreva en-GB. O Google cita UK, junto com EU e UN, como códigos que não têm efeito nas anotações hreflang. A parte de idioma continua valendo, mas a de região não faz nada.
Preciso de x-default?
O Google não exige. O valor reservado x-default diz ao Google qual página usar quando nenhum outro idioma ou região corresponde à configuração do navegador do usuário. Ele foi pensado para páginas de seleção de idioma, mas você pode usá-lo em qualquer página. O verificador avisa quando ele está ausente.
Por que o verificador busca as outras páginas?
Porque o hreflang só funciona em pares. O Google diz que, se duas páginas não apontarem uma para a outra, as tags serão ignoradas. A única forma de confirmar isso é abrir cada alternativa e ler as anotações dela, e é exatamente o que o verificador faz com até 10 delas.
O hreflang diz ao Google em que idioma está a minha página?
Não. O Google diz que não usa o hreflang nem o atributo lang do HTML para detectar o idioma de uma página; ele usa algoritmos próprios. O hreflang diz ao Google quais outras versões da página existem e a quem cada uma se destina.