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).

O Google não diferencia letras maiúsculas e minúsculas nos valores de hreflang: zh-CN, zh-cn e zh-cN são aceitos. A região em maiúsculas segue a convenção ISO e facilita a consistência, mas o requisito real é utilizar códigos de idioma e região válidos.

Cada versão localizada deve apontar para si mesma e para as outras versões disponíveis de forma recíproca. x-default é opcional e pode indicar uma página padrão ou seletor de idiomas para visitantes sem correspondência. Sua ausência não invalida as outras anotações.

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 — Usar códigos de idioma ou região inválidos ou não aceitos. O Google interpreta hreflang sem diferenciar maiúsculas e minúsculas; colocar regiões em maiúsculas segue a convenção ISO, não é uma exigência de indexação. Corrija códigos inválidos, não a capitalização.

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 — Apontar x-default para uma página pouco útil. x-default é opcional; se usado, deve levar visitantes sem idioma correspondente a uma página padrão ou seletor apropriado. Apenas omiti-lo não causa um erro de hreflang.

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.

Etapa 1 — Inspecione o HTML renderizado ou as anotações do sitemap. Confira códigos válidos, a referência à própria versão, links recíprocos e URLs de destino rastreáveis. Verifique x-default somente se você optar por essa alternativa opcional.

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.

Prática 2 — Considere um x-default opcional para idiomas não atendidos, especialmente em um seletor de idiomas. Escolha o destino conforme a experiência do visitante, não automaticamente pelo país da empresa. A ausência de x-default não invalida os links hreflang válidos.

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. 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.

Hoje, o Cogo Site oferece edição de conteúdo multilíngue, rascunhos de tradução por IA que você revisa e um seletor de idioma para seus visitantes.

O Cogo Site ainda não gera tags hreflang nem alternativas no sitemap para os sites que você publica, e trocar de idioma não altera a URL da página.

Se sua estratégia de SEO depende de URLs separadas por idioma com hreflang, o Cogo Site ainda não é a melhor opção.