Hreflang para sites multilíngues: guia prático
Como o hreflang funciona, as regras que o tornam válido, os erros mais comuns e como implementá-lo com segurança em um site multilíngue moderno.
O hreflang informa aos buscadores que várias URLs são versões da mesma página para idiomas ou regiões diferentes. Quando funciona, o usuário chega à versão no seu idioma. Quando está errado, a versão errada pode ranquear, ou várias versões passam a competir entre si.
O que o hreflang realmente faz
Hreflang é uma anotação que conecta páginas equivalentes. Ele não faz uma página ranquear e é um sinal, não uma diretiva: os buscadores podem ignorar anotações que consideram inconsistentes.
Você pode declará-lo de três formas. Escolha uma e use com consistência:
- elementos
<link rel="alternate" hreflang="…" href="…">no<head>do HTML - cabeçalhos HTTP
Link(úteis para arquivos que não são HTML, como PDFs) - entradas
xhtml:linkem um sitemap XML
As regras que tornam o hreflang válido
- Use códigos válidos. O idioma é um código ISO 639-1 (
en,it,pt). A região, opcional, usa ISO 3166-1 Alpha-2 (pt-BR,en-GB). Só a região é inválido, een-UKé um erro clássico: o código correto éen-GB. - Reciprocidade. Se a página A aponta para a página B, a página B precisa apontar de volta para a A. A falta de links de retorno é o motivo mais comum para as anotações serem ignoradas.
- Autorreferência. Cada página inclui a si mesma no próprio conjunto de hreflang.
- Aponte para URLs canônicas e indexáveis. Toda URL do cluster deve responder com status 200, ser indexável e se declarar canônica. Apontar para URLs com redirecionamento,
noindexou não canônicas quebra o cluster. - Inclua
x-default. Ele define a versão padrão para usuários cujo idioma ou região não corresponde a nenhuma versão. Geralmente é um seletor de idioma ou o mercado principal.
Um exemplo mínimo e correto
<link rel="canonical" href="https://example.com/pt-br/servicos/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/services/" />
<link rel="alternate" hreflang="it" href="https://example.com/it/servizi/" />
<link rel="alternate" hreflang="pt-BR" href="https://example.com/pt-br/servicos/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/en/services/" />
O canonical aponta para a própria página, e não para a versão em inglês. Canonicalizar todos os idiomas para uma única versão diz aos buscadores que as traduções são duplicadas, ou seja, o contrário do que você quer.
Erros comuns
- Canonical para outro idioma. Cada versão de idioma deve ser canônica de si mesma.
- Redirecionamentos automáticos por IP ou idioma do navegador. Os rastreadores podem nunca ver algumas versões. Sugira um idioma em vez de forçar o redirecionamento.
- Traduções parciais. Uma página com apenas o menu traduzido não é uma alternativa real. Traduza o conteúdo principal.
- URLs inconsistentes. Diferenças de barra final,
httpehttpsouwwwe semwwwcriam referências a URLs que redirecionam.
Implementando em um framework moderno
Em frameworks como Next.js, gere canonical e hreflang a partir do mesmo mapa de rotas que produz as URLs localizadas. Assim, uma página nova ou um slug traduzido não podem ser publicados com um cluster quebrado. Neste site, uma única função monta o canonical, todos os alternates e o x-default de cada página, e testes automatizados verificam se cada cluster está completo e recíproco.
Como verificar
Rastreie o site com uma ferramenta que reporte hreflang (a maioria dos crawlers de SEO faz isso), confira se cada cluster está completo e recíproco e acompanhe no Search Console os problemas de indexação de cada versão de idioma. Corrigir hreflang raramente é glamouroso, mas em sites multilíngues costuma ser uma das tarefas técnicas de maior impacto.