Saltar para o conteúdo
Voltar aos guias
Guia Última verificação: outubro de 2026 10 min de leitura

Erros de hreflang e como corrigi-los

As ligações hreflang só funcionam como um conjunto completo. Este guia mostra os erros que mais vezes estragam um conjunto destes, como encontrá-los e como corrigi-los.

Porque é que pequenos erros estragam o hreflang

As ligações hreflang dizem aos motores de pesquisa que páginas são versões do mesmo conteúdo noutros idiomas ou para outras regiões. Cada versão tem de confirmar as outras. Um código errado, uma ligação de retorno em falta ou uma versão que redireciona podem bastar para que parte do conjunto seja ignorada. Como criar as versões de idioma e os respetivos endereços é tratado no nosso guia Traduzir o teu site. Este guia trata dos erros que ficam depois disso.

Três versões da mesma página num triângulo. Cada par está ligado por uma seta nos dois sentidos, e cada página tem uma pequena seta que aponta para si própria: cada versão nomeia todas as outras e a si própria.
Um conjunto completo: ligações de retorno entre todas as versões e uma autorreferência em cada página.

Como verificar um conjunto

Começa numa página, recolhe as suas ligações hreflang e depois abre cada versão que ela indica. Só então consegues ver se as versões estão de acordo umas com as outras.

Como verificar um conjunto hreflang
Recolher as ligações
Todas as entradas hreflang da página inicial
Verificar os códigos
Idioma em ISO 639-1, região em ISO 3166-1
Abrir cada versão
Estado 200, sem redirecionamento, sem noindex
Verificar as ligações de retorno
Cada versão indica todas as outras e a si própria
Verificar o canonical
Cada versão nomeia-se a si própria
Verificar o x-default
No máximo um, igual em todas as páginas
Começa numa página e segue cada versão que ela indica.

Erro 1: faltam ligações de retorno

É o primeiro ponto da lista de erros comuns que a Google publica. Se a página A indica a página B como a sua versão alemã, a página B também tem de indicar a página A. A Google escreve que as etiquetas são ignoradas se duas páginas não apontarem uma para a outra. Isto acontece quando um novo idioma é acrescentado só a algumas páginas, ou quando cada idioma vive num sistema separado. A correção é criar o bloco de ligações hreflang a partir de uma única lista de todas as versões e pôr o mesmo bloco em todas as páginas do conjunto.

Cada versão tem ligação de retorno?
A versão indicada nomeia esta página nas suas próprias ligações hreflang, exatamente com o mesmo endereço?
Sim
O par confirma-se. A Google pode usar as anotações entre estas duas páginas.
Não
A Google pode ignorar as anotações entre estas duas páginas. Acrescenta a ligação em falta na página que não a tem.
Faz esta pergunta para cada par de páginas do conjunto.

Erro 2: códigos de idioma ou de região errados

  • en-UK em vez de en-GB. O código ISO do Reino Unido é GB. A Google escreve que códigos reservados como UK, EU ou UN não têm efeito no hreflang.
  • Um código de país sozinho, como us ou jp. A Google não aceita uma região sem idioma. O código de idioma do japonês é ja, por isso uma página para o Japão usa ja ou ja-JP.
  • Um país confundido com um idioma. O exemplo que a Google dá: be é o código do bielorrusso, não da Bélgica. Uma página em francês para a Bélgica usa fr-BE.
  • Um sublinhado, como em en_GB. Segundo o W3C, as partes de uma etiqueta de idioma separam-se com hífen.
  • Códigos válidos noutros contextos, mas não para a Google. es-419 significa espanhol da América Latina e é uma etiqueta de idioma válida segundo o W3C, mas a Google escreve que não a suporta.
Códigos errados e certos
Errado
  • en-UK
  • jp (um país, não um idioma)
  • be para a Bélgica (be é bielorrusso)
  • en_GB (sublinhado)
  • es-419 (não suportado pela Google)
Certo
  • en-GB
  • ja ou ja-JP
  • fr-BE ou nl-BE
  • en-GB (hífen)
  • es, ou um código por país, como es-MX
Maiúsculas e minúsculas não importam para a Google: en-gb e en-GB são o mesmo.

Erro 3: a página não se indica a si própria

A Google escreve que cada versão de idioma tem de se indicar a si própria, além de todas as outras versões. Uma página que só nomeia os outros idiomas não tem a sua própria entrada. Uma causa possível: o mesmo ciclo cria também o seletor de idioma, e o seletor esconde muitas vezes o idioma ativo. Mantém os dois separados: o seletor pode esconder o idioma atual, o bloco hreflang não pode.

Erro 4: x-default em falta ou incoerente

x-default é um valor reservado. A Google usa-o quando nenhum outro idioma ou região corresponde às definições do navegador do visitante e recomenda-o como alternativa, por exemplo para uma página em que os visitantes escolhem o idioma. Não és obrigado a usá-lo. Se o usares, usa-o uma vez por conjunto, põe a mesma entrada em todas as páginas e faz com que aponte para uma página que funcione para visitantes de qualquer lugar, como uma página de escolha de idioma ou a tua versão principal. Erros típicos: um x-default que muda de página para página, duas entradas x-default num conjunto ou uma que aponta para uma página que redireciona os visitantes consoante a localização.

Erro 5: o canonical aponta para outro idioma

A etiqueta canonical diz que endereço é a versão principal entre duplicados de uma página. A Google aconselha indicar uma página canónica no mesmo idioma ou, se não houver página canónica nesse idioma, no melhor idioma substituto possível. Se a página alemã nomear a página inglesa como canónica, os sinais contradizem-se: o hreflang diz que a página alemã é uma versão própria, o canonical diz que é uma cópia da página inglesa. A correção: cada versão de idioma nomeia-se a si própria como canónica, e as versões são ligadas com hreflang.

O canonical e o hreflang fazem trabalhos diferentes
O rel=canonical escolhe entre duplicados da mesma página, o hreflang liga traduções. Segundo a Google, uma ligação canonical que tenha um atributo hreflang não é usada para a canonicalização. A Google escreve também que as versões de idioma só contam como duplicados se o conteúdo principal ficar por traduzir.

Erro 6: ligações para redirecionamentos, páginas noindex ou erros

  • Redirecionamentos. Uma ligação hreflang para um endereço que redireciona nomeia um endereço que não é a própria página. A Google trata um redirecionamento como um sinal forte de que o seu destino deve ser o endereço canónico. Indica o endereço final. É pior se uma versão redirecionar para outra versão de idioma, porque então dois códigos levam à mesma página.
  • noindex. Uma página com noindex fica fora da Pesquisa Google, por isso uma ligação hreflang para ela aponta para uma versão que não pode ser mostrada. Remove o noindex ou retira a página do conjunto em todas as páginas.
  • Erros. Uma versão que responde com 404 ou com um erro de servidor não consegue confirmar o conjunto. Restaura-a ou retira-a do bloco em todas as páginas.

Erros menores fáceis de não ver

  • Endereços quase iguais. http e https, com e sem www, com e sem barra no fim são endereços diferentes. A ligação de retorno tem de nomear exatamente o endereço da página.
  • Endereços relativos como /de/preise/. A Google exige endereços completos, incluindo https://.
  • Vários métodos que não coincidem. Para a Google, os elementos link no HTML, o cabeçalho HTTP e o sitemap são equivalentes, e usar mais de um não traz vantagem na Pesquisa. Usa um só método.

Corrigir pela ordem certa

  1. 1Faz uma lista de todas as versões de uma página: código e endereço final exato.
  2. 2Verifica cada endereço: estado 200, sem redirecionamento, sem noindex, canonical a apontar para si próprio.
  3. 3Cria o bloco hreflang a partir desta lista, incluindo a autorreferência e, se quiseres, um único x-default.
  4. 4Põe o mesmo bloco em todas as páginas do conjunto, com um só método.
  5. 5Volta a verificar o conjunto após cada relançamento e cada novo idioma. Começa pelas páginas com mais visitantes (conselho nosso, não uma regra da Google).

Verifica o teu hreflang com o Do4U

A Verificação de hreflang faz estes passos para uma página e todas as suas versões. Introduzes um endereço. O Do4U lê a página, recolhe as suas ligações hreflang e depois lê cada versão indicada. O código verifica as ligações de retorno e as autorreferências, os códigos de idioma e de região, o x-default e os duplicados, e se cada versão é acessível sem redirecionamento, não tem noindex, nomeia o canonical certo e tem um html lang correspondente. Recebes uma lista das páginas com erros e avisos, uma explicação curta para cada resultado e uma matriz das ligações de retorno. Funciona sem IA e é grátis, com um limite diário por conta.

A verificação lê apenas os elementos link no HTML. Não lê hreflang em cabeçalhos HTTP nem em sitemaps e não executa JavaScript. O Do4U encontra pistas; tu verificas e decides. Ligações hreflang corretas não são uma promessa de melhor classificação.

Fontes