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.
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.
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.
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.
- 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)
- 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
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.
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
- 1Faz uma lista de todas as versões de uma página: código e endereço final exato.
- 2Verifica cada endereço: estado 200, sem redirecionamento, sem noindex, canonical a apontar para si próprio.
- 3Cria o bloco hreflang a partir desta lista, incluindo a autorreferência e, se quiseres, um único x-default.
- 4Põe o mesmo bloco em todas as páginas do conjunto, com um só método.
- 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
- Google Search Central: informar a Google sobre as versões localizadas da tua página (página atualizada a 21 de setembro de 2026) (em inglês) (developers.google.com)
- Google Search Central: como especificar um URL canónico (página atualizada a 10 de julho de 2026) (em inglês) (developers.google.com)
- W3C Internationalization: escolher uma etiqueta de idioma (em inglês) (www.w3.org)