Traduzir uma página e colocá-la no menu de idiomas resolve o caminho do visitante. Para relacionar essas versões no Google, o site também precisa publicar as referências certas. Os erros de hreflang aparecem quando o código liga páginas que não se correspondem, usa um código inválido ou deixa de indicar o caminho de volta. A revisão começa pelas páginas que deveriam formar esse par.
Comece pelo par de páginas que deveria se corresponder
Escolha um serviço, uma categoria ou um produto disponível em dois idiomas. Abra os dois endereços e compare o conteúdo. Eles precisam representar versões localizadas da mesma página, mesmo que preço, moeda ou detalhes de atendimento mudem conforme a região.
É diferente de ligar todo artigo em português à home em inglês. A página inicial não substitui a tradução daquele artigo. Se a versão equivalente ainda não existe, não preencha essa referência com qualquer endereço só para completar o campo do plugin.
Veja também se as duas URLs abrem diretamente, sem erro, bloqueio de indexação ou uma cadeia de redirecionamentos. As referências devem usar o destino atual. Isso vale tanto para pastas no mesmo domínio quanto para versões publicadas em domínios diferentes.
O hreflang informa a relação entre as versões. Ele não traduz o conteúdo nem determina sozinho qual idioma o Google identifica na página. O texto publicado precisa estar no idioma que você está oferecendo.
Confira os códigos de idioma e região
O código começa pelo idioma. A região é opcional e entra quando você precisa diferenciar públicos que usam a mesma língua. pt indica português; pt-BR, português para o Brasil; pt-PT, português para Portugal.
Usar apenas BR deixa o idioma de fora. E, para o Reino Unido, o código de região aceito é GB, como em en-GB. Não use UK por ser uma abreviação conhecida no dia a dia.
A escolha deve acompanhar o conteúdo e o atendimento. Se você tem uma única versão em inglês para vários mercados, pode usar en. Não precisa criar uma variação para cada país sem que haja uma página correspondente.
Há ainda o valor x-default, que aponta para uma página de fallback quando nenhum dos idiomas ou regiões declarados corresponde ao usuário. Ele combina, por exemplo, com um seletor de idiomas. Não é um idioma adicional nem deve receber um código de país junto.
Em um projeto de WordPress multilíngue, confira o que o plugin está emitindo depois de configurar as línguas. O nome mostrado no painel pode estar correto enquanto o código publicado usa outro valor.
Use uma linha da planilha para cada conjunto de traduções
Monte colunas para a página em português, a equivalente em inglês e os demais idiomas existentes. Cada linha deve representar o mesmo conteúdo, como um serviço ou um produto. Acrescente status HTTP, idioma declarado e canonical de cada versão. Você passa a enxergar a correspondência antes de conferir as tags.
Uma célula vazia significa que aquela tradução não existe. Preserve essa informação. Preencher todos os espaços com a home do país cria pares que não atendem à mesma necessidade. Um artigo que só existe em português pode continuar publicado sem apontar uma falsa tradução em inglês.
Para versões regionais, compare também o que muda para a pessoa: moeda, disponibilidade, condições de entrega ou atendimento. O código de país deve refletir a versão oferecida. Não acrescente dezenas de países ao mesmo endereço para tentar ganhar presença em cada mercado; mantenha a configuração compatível com as páginas que existem.
Veja se as páginas apontam uma para a outra
Em uma implementação com tags no HTML, cada versão lista a si mesma e as demais versões equivalentes. As referências usam URLs completas e ficam no <head>. No exemplo didático abaixo, há uma página em português e outra em inglês:
<link rel="alternate" hreflang="pt-BR"
href="https://exemplo.com/pt/servico/">
<link rel="alternate" hreflang="en"
href="https://exemplo.com/en/service/">Esse mesmo conjunto deve aparecer nas duas páginas. A versão em português aponta para a inglesa; a inglesa aponta de volta. Cada uma também aparece na própria lista.
Se o retorno não existe, o Google pode ignorar aquela relação. Por isso, olhar apenas o código da página em português deixa metade do teste por fazer. Abra o destino e procure as referências nele também.
O site pode publicar hreflang no sitemap XML ou em cabeçalhos HTTP, em vez de usar o HTML. Os três métodos são equivalentes para o Google. Escolha uma implementação que a equipe consiga manter. Repetir a configuração nos três lugares aumenta os pontos de revisão e não traz uma vantagem de busca.
Se mais de um método já estiver ativo, compare o que cada um declara. Um sitemap atualizado e um conjunto antigo de tags no tema podem publicar relações diferentes para a mesma página.
Onde o x-default entra nesse conjunto
Se existe uma página que deixa o visitante escolher o idioma, ela pode ser o destino de x-default. A referência é separada das versões em português e inglês:
<link rel="alternate" hreflang="x-default"
href="https://exemplo.com/idioma/">Inclua essa referência no conjunto de páginas relacionadas e mantenha as referências recíprocas. O seletor deve funcionar para quem acessa diretamente. Um redirecionamento automático por IP que impede o Google de abrir uma versão prejudica o teste de todo o conjunto. Oferecer a troca de idioma preserva a escolha do visitante e o acesso aos endereços.
Na página em português, a canonical permanece numa tag própria, por exemplo <link rel="canonical" href="https://exemplo.com/pt/servico/">. Não use o endereço do seletor como canônica das traduções. Ele tem outra função e não substitui o conteúdo localizado.
Resolva os conflitos com a canonical
Hreflang relaciona versões localizadas. A canonical informa a versão preferida para consolidação de páginas iguais ou semelhantes. As duas configurações precisam contar uma história coerente sobre aquele conteúdo.
Para duas traduções distintas como as do exemplo, cada página pode usar a própria URL como canônica. Apontar a tradução em inglês para a página em português entra em conflito com a intenção de manter as duas versões disponíveis na busca.
Já duas versões regionais no mesmo idioma podem ter conteúdo quase idêntico. Nesse caso, a equipe precisa decidir sobre a consolidação antes de repetir uma regra em todo o site. A orientação do Google é indicar uma canônica no mesmo idioma, ou a melhor substituta quando não existir uma opção nesse idioma.
Não misture as funções numa tag só. Use rel="alternate" com hreflang para as versões localizadas e uma tag separada de rel="canonical" para a escolha canônica. Acrescentar hreflang à tag canonical não cria as duas relações ao mesmo tempo.
Na inspeção de URL do Search Console, compare a canônica declarada pelo site com a escolhida pelo Google. Uma escolha inesperada pede examinar o conteúdo e os outros sinais de consolidação. O hreflang é uma parte desse diagnóstico, não uma forma de obrigar o buscador a exibir determinada versão.
Encontre quem está publicando a referência errada
No WordPress, uma tradução pode estar associada ao conteúdo errado no plugin multilíngue. Abra o conteúdo no painel e veja qual página está vinculada a cada idioma. Se a associação estiver trocada, corrigir o vínculo costuma ser mais sustentável do que inserir uma tag manual apenas na página em português.
Procure também emissores duplicados. Um plugin, o tema e um snippet podem publicar hreflang ao mesmo tempo. No código-fonte, pesquise hreflang e compare todas as ocorrências. Duas listas com destinos diferentes deixam a manutenção confusa mesmo quando uma delas está correta. A equipe deve escolher quem cuida da implementação e remover a emissão conflitante.
Se o endereço mudou, atualize o vínculo para a URL final. Uma tradução que redireciona permanentemente para outra precisa ser substituída nas referências. Quando o conteúdo foi encerrado sem equivalente, retire a relação nos dois lados; não deixe as outras páginas continuarem apontando para uma versão que não existe.
Como ler os erros encontrados pelo crawler
| Aviso | Teste | Correção |
|---|---|---|
| Sem referência de retorno | Abra o destino e procure a URL de origem no conjunto publicado. | Corrigir o vínculo e a emissão na página que deixou de apontar de volta. |
| Código inválido | Separar idioma e região e comparar com os códigos aceitos. | Corrigir a configuração de idioma na origem, em vez de remendar cada página. |
| Destino não indexável | Testar status, robots, noindex e canonical da versão indicada. | Restaurar a versão que deve existir ou retirar a relação que deixou de fazer sentido. |
| Conteúdos sem correspondência | Comparar a tarefa que cada página atende. | Vincular a tradução correta; deixar sem equivalente quando ela não existe. |
Depois da alteração, colete o conjunto inteiro novamente. Corrigir só a origem não resolve uma referência de retorno ausente. E esvaziar o cache de uma tradução deixa a outra servindo a lista antiga se o sistema guarda cada idioma separadamente.
O Search Console tem um relatório de hreflang?
O Search Console não oferece mais o relatório específico de segmentação internacional. Use a Inspeção de URL para conferir acesso, indexação e o HTML disponível de uma página. Para validar referências de retorno e destinos de todo um conjunto, use um crawler com análise de hreflang.
Comece por uma linha da sua planilha de traduções e confira as páginas correspondentes. O fato de a versão em português estar indexada não informa se a inglesa aponta de volta para ela. A validação precisa abrir os dois lados da relação.
Como testar a alteração e encontrar o que ainda ficou errado
Eu revisaria um conjunto pequeno antes de ampliar a correção para todos os idiomas. Escolha páginas de modelos diferentes, como home, serviço e artigo. Um plugin pode acertar as referências dos posts e errar as de uma página montada pelo tema.
Para cada conjunto, anote os endereços finais e os códigos declarados. Depois compare as referências de ida e volta. Um crawler com validação de hreflang consegue reunir falhas de retorno, códigos incorretos e destinos que redirecionam ou respondem com erro.
A conferência fica mais clara quando você separa:
- Correspondência: cada destino oferece a versão correta daquele conteúdo.
- Acesso: as URLs finais abrem e podem participar da indexação.
- Referências: as páginas listam a si mesmas e apontam de volta para as versões relacionadas.
- Consolidação: a canonical acompanha a decisão tomada para cada idioma ou região.
Depois de publicar, veja a resposta entregue ao visitante, além da configuração salva no painel. Cache, tema e integrações podem manter tags antigas em circulação. Repita a coleta nos modelos que você alterou e só então avance para o restante do acervo.
As regras para versões localizadas detalham os códigos e os métodos aceitos. Guarde essa referência para casos com muitas regiões, em vez de resolver exceções acrescentando tags sem um mapa das páginas.
Conclusão
Uma página em português e sua versão correspondente em outro idioma já oferecem uma boa amostra. Abra as duas e verifique as referências de ida e volta, o conteúdo e a canonical. Corrija o modelo responsável pela diferença antes de repetir a mesma tag em todo o site.
Na consultoria de SEO internacional, reviso essas relações com quem mantém o projeto. Traga os mercados atendidos e as versões existentes para alinharmos os endereços e as configurações ao SEO técnico do site.
