Guia de Hreflang: Sintaxe, Erros e Melhores Práticas

Hreflang (também chamado de 'rel=alternate hreflang') é um atributo de link HTML que informa aos mecanismos de busca qual versão de idioma e região de uma página mostrar nos resultados de quais pesquisadores. Foi introduzido pelo Google em 2011 para resolver o problema de conteúdo duplicado que sites multilíngues enfrentam: se você tem uma página em inglês e uma página em espanhol com o mesmo conteúdo, o Google pode tratar uma como duplicata da outra e indexar apenas uma. O hreflang diz ao Google 'estas são alternativas intencionais para públicos diferentes — indexe ambas e direcione os pesquisadores adequadamente.'

Sem hreflang, um pesquisador nos EUA que busca 'plumber near me' pode ver sua página em espanhol (porque o Google acha que ela é relevante para a consulta) — e sair porque não lê espanhol. Com o hreflang correto, o Google mostra sua página em inglês ao pesquisador nos EUA e sua página em espanhol ao pesquisador no México. O resultado: melhor engajamento, maior conversão e sem canibalização entre locales.

O hreflang importa mais para: empresas de serviços multilíngues (comunidades de imigrantes, profissionais transfronteiriços), e-commerce internacional e qualquer site que publique o mesmo conteúdo em vários idiomas. Se seu site é de um único locale, o hreflang é desnecessário — o Google lida com ele corretamente sem o atributo.

O hreflang usa o atributo de link rel=alternate com um valor hreflang. O valor combina um código de idioma ISO 639-1 com um código de região opcional ISO 3166-1 alfa-2. Exemplos: en (inglês, qualquer região), en-US (inglês Estados Unidos), zh-CN (chinês simplificado, China continental), zh-TW (chinês tradicional, Taiwan), es-MX (espanhol México), fil-PH (filipino Filipinas).

Crítico: os códigos de região diferenciam maiúsculas de minúsculas. zh-CN está correto; zh-cn ou zh-cN não estão. O Google ignora maiúsculas/minúsculas incorretas silenciosamente. Sempre use subtags de região em maiúsculas conforme o padrão ISO.

Uma implementação completa de hreflang exige três peças em cada página: (1) uma tag hreflang autorreferencial (a página declarando seu próprio locale), (2) uma tag hreflang para cada outra versão de locale (as alternativas) e (3) uma tag x-default apontando para o locale a mostrar quando nenhuma alternativa corresponde ao pesquisador. A falta de qualquer uma delas quebra a implementação.

Toda alternativa deve ser bidirecional. Se a página A (inglês) declara a página B (chinês) como sua alternativa, a página B deve declarar a página A como sua alternativa. A falta de tags de retorno é o erro de hreflang mais comum — o Google ignora ambas as direções quando uma está faltando.

Erro 1 — Caixa incorreta do código de locale. zh-cn em vez de zh-CN, fil-ph em vez de fil-PH. O Google ignora tags com caixa incorreta silenciosamente. Correção: sempre use subtags de região em maiúsculas.

Erro 2 — Tags de retorno ausentes. A página A declara a página B como alternativa, mas a página B não declara a página A. Correção: toda alternativa deve ser bidirecional; se você adicionar um novo locale, atualize todas as páginas existentes para declará-lo de volta.

Erro 3 — x-default ausente ou incorreto. Sem x-default, o Google adivinha qual locale mostrar para pesquisadores sem correspondência; geralmente escolhe seu locale mais indexado, que pode não ser o que você quer. Correção: declare explicitamente o x-default (geralmente apontando para seu locale comercial principal).

Erro 4 — URLs de hreflang que não correspondem às URLs canônicas. Se /pricing tem canônica /pricing, mas seu hreflang aponta para /pricing?utm_source=internal, o Google ignora a alternativa. Correção: as URLs de hreflang devem corresponder às URLs canônicas caractere por caractere.

Erro 5 — Hreflang em páginas noindex ou canonicalizadas para outra URL. Páginas bloqueadas para indexação não devem declarar hreflang. Correção: omita tags hreflang em rotas noindex, rotas redirecionadas e páginas canonicalizadas para outras URLs.

Erro 6 — Hreflang para páginas soft-404 ou 'locale não disponível'. Não declare uma URL alternativa que retorne uma mensagem 'desculpe, esta página não está disponível no seu idioma' — isso é um soft 404 e o Google penaliza ambas as direções. Correção: declare apenas alternativas que contenham conteúdo real; se uma página não existe em um locale, não declare esse locale como alternativa.

Erro 7 — Variantes de locale inconsistentes entre páginas. A página A declara os locales en, zh-CN, es, mas a página B declara apenas en e zh-CN. A inconsistência confunde o Google. Correção: toda página que existe em vários locales deve declarar todos os locales onde existe — e nenhum locale onde não existe.

Passo 1 — Inspecione o HTML renderizado. Veja o código-fonte de qualquer página multilíngue e verifique a seção head em busca de tags link rel=alternate. Você deve ver uma tag autorreferencial, uma tag por locale alternativo e uma tag x-default. Verifique a caixa, a correspondência de URLs e as tags bidirecionais.

Passo 2 — Google Search Console. Em Direcionamento Internacional > País, o Google reporta erros de hreflang que encontra no seu site. Erros comuns: tags de retorno ausentes, códigos de locale errados, URLs alternativas quebradas. Corrija todos os erros que o Google reportar.

Passo 3 — Rastreamento com Ahrefs ou Sitebulb. Essas ferramentas detectam problemas de hreflang em escala — incompatibilidades de tags bidirecionais em milhares de páginas, alternativas quebradas, códigos de locale incorretos. Faça um rastreamento completo do site trimestralmente.

Passo 4 — Teste manual na SERP. Pesquise o nome da sua marca a partir de dispositivos de locales diferentes (use uma VPN ou os domínios específicos por país do Google, como google.com.hk para Hong Kong) e verifique se a versão correta do locale aparece. Se você vir canibalização de locale (versão errada rankeando na região errada), o hreflang provavelmente é a causa.

Passo 5 — Verifique a indexação no Search Console. Use a Inspeção de URL em cada versão de locale de uma página para confirmar que o Google indexou todas as alternativas. Se uma versão de locale não estiver indexada, o hreflang não está passando o sinal corretamente.

Melhor prática 1 — Use códigos apenas de idioma (en, zh, es) quando você não tem conteúdo específico por região. Use códigos de região (en-US, en-GB, zh-CN, zh-TW) apenas quando o conteúdo realmente difere por região (moeda, referências legais, vocabulário). Especificar demais os códigos de região quando o conteúdo é idêntico cria alternativas desnecessárias.

Melhor prática 2 — Defina o x-default para seu locale comercial principal (geralmente o locale do país de origem da sua empresa). Para uma empresa dos EUA, x-default = en ou en-US. Para uma empresa chinesa com uma versão em inglês, x-default = zh-CN se seu público principal é chinês, en se for internacional.

Melhor prática 3 — Gere hreflang a partir de uma única fonte de verdade (seu CMS ou construtor de sites). Manter o hreflang manualmente em milhares de páginas garante divergência. Cogo Site, WordPress + WPML e os recursos multilíngues do Shopify geram hreflang automaticamente; escolha um construtor que faça isso.

Melhor prática 4 — Mantenha as URLs de hreflang limpas e estáveis. Não inclua parâmetros de consulta, IDs de sessão ou parâmetros de rastreamento nas URLs de hreflang. Depois que uma URL alternativa é publicada, não a altere sem um redirecionamento — o cache de hreflang do Google leva semanas para se reconstruir.

Melhor prática 5 — Audite o hreflang após cada lançamento de locale, remoção de locale ou migração importante de conteúdo. Divergências acontecem; o hreflang é o canário na mina de carvão para a saúde de sites multilíngues.

O Cogo Site gera hreflang a partir de uma única fonte de verdade — o roteamento de URL com prefixo de locale. Cada página inclui automaticamente tags autorreferenciais, alternativas e x-default com caixa ISO correta, tags de retorno bidirecionais e URLs que correspondem às canônicas. Você não escreve as tags; você não as mantém.

Adicionar um locale regenera o hreflang em todas as páginas atomicamente — não há janela em que páginas existentes estejam sem a nova alternativa. Remover um locale retira de forma limpa o hreflang para esse locale de todas as páginas, evitando soft-404s.

A visibilidade de locale por página permite marcar uma página como somente inglês ou somente chinês — o hreflang só declara alternativas onde ambas existem, evitando o erro da 'alternativa soft-404'.

O locale x-default é configurável por site, com padrão para o locale de publicação original. As URLs de hreflang derivam do mesmo roteamento das URLs canônicas, então não podem divergir.