Hreflang: como conferir links de volta entre idiomas

O hreflang relaciona versões equivalentes de uma página por idioma ou região. Para conferir um par, abra a primeira página e localize o endereço declarado para a segunda. Depois, faça o caminho inverso. Em uma configuração HTML com duas versões, cada página inclui a própria referência e a da outra. Por isso, o Google ignora a relação quando falta o retorno. Orientações sobre versões localizadas

Comece pela página em que a revisão faz diferença. Por exemplo, se a página de um produto aparece em inglês para quem procura em português, confira os dois endereços e a marcação publicada. Assim, você consegue mostrar à equipe qual referência está faltando ou leva ao lugar errado.

O que conferir antes de revisar o hreflang

Primeiro, confirme a equivalência. Duas versões de uma ficha de produto podem ter texto, moeda e condições locais diferentes, desde que atendam à mesma necessidade. Já uma ficha de produto e a página inicial respondem a tarefas distintas. Nesse caso, a página inicial é um destino inadequado para declarar aquela ficha como traduzida.

Em seguida, abra cada URL sem depender do seletor de idiomas. Depois, confira o conteúdo principal, o endereço final e a troca de idioma pela navegação. Além disso, observe se um redirecionamento leva à versão esperada. O Google recomenda URLs distintos para idiomas diferentes e acesso às versões por links. Como gerenciar sites multilíngues

Fontes da indicação de idioma

O hreflang pode sair do HTML, de um cabeçalho da resposta HTTP ou do sitemap XML. Primeiro, identifique o método com a equipe. Assim, você compara a saída que o site entrega de fato com o cadastro. Se o site usa mais de um método, confira se todos apontam para os mesmos destinos.

Já o atributo lang informa o idioma de um texto ou de um elemento. No exemplo de uma página em inglês com uma citação em português, é possível declarar o idioma da citação na própria página. Para esse caso, veja como conferir o atributo lang.

Como montar a matriz de hreflang para duas páginas

Imagine uma loja que vende a mesma xícara em um site com dois idiomas. A página para o público brasileiro está em https://example.com/pt-br/xicara/, com o código pt-BR. A versão em inglês está em https://example.com/en/cup/, com o código en. Primeiro, anote o endereço e o código de cada variante. Em seguida, confira o que sai de cada página.

As duas referências no cabeçalho HTML

Primeiro, em uma implementação HTML, procure os elementos link com rel="alternate" e o atributo hreflang dentro da seção head. Em seguida, na página brasileira, o endereço de pt-BR deve ser o dela. Por outro lado, o destino de en deve abrir a versão em inglês. Depois, procure as mesmas duas referências na página em inglês. Sintaxe das versões localizadas em HTML

No exemplo, as duas páginas usam este mesmo conjunto no cabeçalho. Assim, cada variante aparece uma vez com o endereço completo.

<link rel="alternate" hreflang="pt-BR" href="https://example.com/pt-br/xicara/">
<link rel="alternate" hreflang="en" href="https://example.com/en/cup/">

Página em português

pt-BR aponta para /pt-br/xicara/ e en aponta para /en/cup/.

Página em inglês

en aponta para /en/cup/ e pt-BR volta para /pt-br/xicara/.

As duas autorreferências

Cada página também declara o seu próprio código e endereço. Nos registros do site, use os endereços completos.

Descrição da matriz de idiomas

A primeira linha sai da página em português do Brasil. A entrada pt-BR repete o seu endereço e a entrada en indica a página equivalente em inglês. A segunda linha sai da página em inglês. A entrada pt-BR volta ao endereço em português, enquanto a entrada en repete o próprio endereço em inglês.

Um retorno que parece certo até você abrir o link

Imagine que a página em inglês declare pt-BR, mas indique https://example.com/pt-br/. Assim, o destino leva à página inicial brasileira. Nesse caso, o código serve ao idioma, porém o endereço pertence a outro conteúdo. Por isso, corrija a URL na origem em inglês e confira as referências nos dois lados.

Assim, a revisão separa a presença do código, o endereço declarado e a página que o destino abre. Por fim, confirme também as duas autorreferências. Em sites com várias versões, a prioridade é validar o par que afeta a página em revisão e, em seguida, ampliar a conferência para as demais variantes.

Como corrigir e conferir o hreflang publicado

Primeiro, corrija a saída no sistema que produz a indicação. Por exemplo, se um plugin gera as anotações no HTML, peça à equipe para conferir o vínculo entre as duas páginas desse plugin. Se o endereço errado vem do sitemap, o ponto de correção está no gerador do arquivo. Assim, você consegue corrigir a origem do problema.

Confira também a versão canônica e o endereço final

Em seguida, localize o endereço canônico declarado. Ele indica a página preferida entre endereços iguais ou muito semelhantes. No exemplo, cada tradução tem conteúdo próprio e endereço estável. Por isso, cada página indica o próprio endereço como canônico. Assim, cada ficha mantém sua identidade e o hreflang registra a relação entre elas. Orientações sobre URL canônico e idioma

Se o endereço redireciona, abra o destino final e confira o conteúdo antes de atualizar a anotação. Depois, registre o endereço final e repita a leitura da saída publicada. Para avaliar o comportamento da URL antiga, veja quando usar canonical ou redirecionamento 301.

Além disso, organize essa conferência junto das demais tarefas do site com o guia prático de SEO. Se o site tem muitos pares quebrados, podemos ajudar a priorizar páginas pelo papel que cumprem na busca e na conversão. Veja como comparar o escopo de uma consultoria SEO.

Ficha para conferir os destinos de um par

Primeiro, informe as duas URLs esperadas. Em seguida, transcreva os destinos efetivamente publicados em cada versão. Se uma indicação estiver ausente, deixe o campo correspondente vazio. Por fim, registre se os destinos foram abertos e copie a matriz para enviar à equipe responsável.

Perguntas frequentes sobre hreflang