Tags hreflang explicadas, com gerador e exemplos | We.Inc
Como o hreflang marca versões por idioma e região: códigos válidos, x-default, links de retorno, métodos via HTML, cabeçalho e sitemap, erros comuns e um gerador.
Tags hreflang explicadas
O hreflang diz aos buscadores qual URL mostrar para cada idioma ou região. Cada versão de uma página lista a si mesma e todas as alternativas com link rel="alternate" hreflang="code" e uma URL completa. Os códigos são um idioma ISO 639-1, opcionalmente seguido de uma região ISO 3166-1 como en-GB, e o x-default cobre todos os demais.
Códigos válidos e inválidos
Código
Válido?
Significado
Sim
Inglês, qualquer região
en-GB
Sim
Inglês para usuários no Reino Unido
zh-Hant
Sim
Chinês em escrita tradicional (código de escrita ISO 15924)
Não (para o Google)
Regiões numéricas não são suportadas
Sim
Opção de reserva quando nenhuma outra versão corresponde
GB
Não
Região sozinha não é permitida
en-UK
Não
O código de região do Reino Unido é GB
A maioria dos problemas de hreflang é de organização: uma página esquece de linkar de volta, um código usa a região errada ou as URLs são relativas. O gerador abaixo monta o conjunto completo e simétrico para todas as versões de uma vez, para que cada página leve a mesma lista completa.
Adicione uma linha para cada versão de idioma ou região, com o código e a URL completa.
Se quiser, marque uma URL como x-default, geralmente um seletor de idioma ou a sua versão principal.
Copie as tags link para o head de cada versão, ou use a saída para sitemap em vez disso.
Depois do próximo rastreamento, inspecione algumas das URLs no Search Console para confirmar que o Google captou o conjunto.
Coloque o mesmo conjunto de tags em todas as versões. As tags da página em inglês e da página em francês devem ser a mesma lista.
Use só um método por conjunto de páginas. Misturar tags HTML com entradas no sitemap torna mais difícil manter tudo sincronizado.
O hreflang é uma indicação de qual versão mostrar. Ele não traduz nada, e o Google diz que detecta o idioma de uma página com os próprios algoritmos, não pelo hreflang.
Perguntas frequentes
Preciso de uma tag hreflang que aponte para a própria página?
Sim. A documentação do Google diz que cada versão deve listar a si mesma, além de todas as outras versões. Sem a autorreferência, o conjunto fica incompleto.
Para que serve o x-default?
O x-default indica a página a mostrar quando o idioma ou a região de quem pesquisa não corresponde a nenhuma das versões listadas. Uma página de seleção de idioma ou a sua página inicial internacional costuma ser a escolha.
O que acontece se a página B não linkar de volta para a página A?
O Google exige que os links sigam nos dois sentidos. Se A aponta para B mas B não aponta de volta para A, a anotação pode ser ignorada. Os links de retorno impedem que terceiros afirmem ser uma alternativa da sua página.
Devo usar tags HTML, cabeçalhos HTTP ou o sitemap?
O Google trata os três como equivalentes. Tags HTML servem para a maioria dos sites. Cabeçalhos HTTP Link são a opção para PDFs e outros arquivos que não são HTML. Um sitemap tira a marcação das suas páginas e é mais fácil para sites grandes com muitos idiomas.
Posso segmentar um país sem um idioma?
Não. Um código de região sozinho é inválido. Para segmentar o Canadá em inglês e francês, use en-CA e fr-CA.
Quando vale a pena adicionar hreflang
Use quando o mesmo conteúdo existe em mais de um idioma, ou em um idioma com diferenças regionais reais, como preços, ortografia ou condições de entrega. Ele ajuda o Google a mandar quem pesquisa no México para a página em espanhol mexicano em vez da página em espanhol da Espanha.
Um site em um só idioma para um só mercado não precisa de hreflang. Adicioná-lo ali só cria mais uma coisa para manter.
Erros comuns
URLs relativas não são aceitas; o href precisa incluir https e o host. Underscores estão errados no hreflang: escreva en-GB, não en_GB, que é o estilo de locale do Open Graph.
Listar uma URL que redireciona ou retorna erro desperdiça a anotação. Mantenha o conjunto só com endereços ativos e finais e atualize-o sempre que uma página traduzida for adicionada ou removida.
As três formas de declarar alternativas
Tags link HTML no head
As mesmas cinco linhas vão nas páginas em inglês, em inglês britânico, em alemão e na de seleção.
Cabeçalho HTTP Link para um PDF
Enviado pelo servidor junto com o arquivo, já que um PDF não tem head onde colocar tags.
Entradas no sitemap
Cada elemento url lista todas as versões, inclusive ele mesmo. O namespace xhtml precisa ser declarado no urlset.
Erros e como corrigi-los
O que mais dá errado
Problema
Correção
Falta o link de retorno
Adicione o conjunto completo de tags em todas as versões
Região sem idioma, como hreflang="US"
Use idioma mais região, como en-US
Código de região errado, como en-UK
Use o código ISO 3166-1 GB
href relativo
Escreva a URL completa com https e host
A URL alternativa redireciona ou retorna 404
Liste só URLs ativas e finais
Região sozinha não é válida; adicione um idioma, como en-{code}
Use hífen, não underscore
O código de região do Reino Unido é GB
Esperado um formato como en, en-GB ou zh-Hant
A URL precisa ser absoluta, com https e host
O mesmo código aparece duas vezes
Gerador de hreflang
Adicione o código e a URL completa de cada versão. O gerador confere os códigos e escreve o conjunto de tags e o bloco de sitemap para todas as versões de uma vez.
Código
URL
Remover {name}
Remover linha
Remover
Adicionar versão
URL x-default (opcional)
Formato de saída
Tags HTML
Sitemap
Os códigos e as URLs parecem válidos. Coloque este mesmo conjunto em todas as versões.