Hreflang para sites internacionais
Configure hreflang por idioma e região, valide reciprocidade, canonicals e x-default e evite que versões LATAM concorram entre si.
Nesta página
O que é e como funciona
Hreflang sinaliza versões alternativas de uma página para diferentes idiomas ou regiões. Não é um mecanismo de tradução nem substitui arquitetura consistente e conteúdo localizado.
Em operações internacionais, traduções incompletas, URLs migradas, mudanças de domínio e canonicals apontando para outro país quebram o conjunto de alternates. O problema aparece quando cada mercado evolui o site em ritmos diferentes.
Qual problema resolve
Resolve a exibição da versão errada de uma página para usuários de outro idioma ou país, em sites com conteúdo equivalente para vários mercados. Sem o hreflang, versões em espanhol e português podem competir entre si nos resultados, ser tratadas como duplicadas, ou um usuário no Chile pode ser levado à página destinada ao Brasil.
A sinalização recíproca indica ao buscador qual versão corresponde a cada público, preservando a relevância de cada mercado. Não corrige conteúdo mal localizado nem substitui uma arquitetura consistente de idiomas e regiões.
Uma configuração incorreta pode fazer a busca apresentar uma versão menos adequada ao idioma ou país do usuário, prejudicando entendimento, preço/moeda e conversão. Hreflang não substitui localização real de conteúdo nem garante segmentação.
Quando utilizar
- Um mesmo conteúdo existe em versões destinadas a países ou idiomas diferentes.
- Há versões de páginas equivalentes em mercados LATAM.
Quando não utilizar
- Há apenas uma versão de idioma/região sem alternativa equivalente.
- As páginas representam produtos ou serviços diferentes e não são equivalentes entre mercados.
- O problema é tradução insuficiente, geobloqueio ou canonical incorreta; hreflang isoladamente não resolve essas causas.
Matriz de decisão
| Situação | O que usar | Por quê |
|---|---|---|
| Mesmo conteúdo em pt-BR e es-CL com URLs distintas e equivalentes | hreflang recíproco e autorreferente, canonical própria em cada versão | Cada mercado recebe a versão adequada sem competir entre si. |
| Mesma língua em países diferentes com preço, moeda ou sortimento diferentes (es-CL, es-MX) | hreflang por idioma-região (es-CL, es-MX); um es genérico só como versão para os demais países de língua espanhola, se ela existir | País não é idioma; a diferença comercial justifica versões separadas. Usar só es quando há versões comerciais distintas por país esconde essa diferença. |
| Só existe uma versão de idioma/região | Não usar hreflang | Sem alternativa equivalente não há o que relacionar. |
| Página só parcialmente traduzida ou produto inexistente no mercado | Deixar fora do cluster até existir equivalente real | Equivalência falsa envia o usuário a conteúdo errado e pode invalidar as anotações. |
| Usuário sem mercado definido (idioma/país não atendidos) | x-default apontando para a página de seleção de país ou para a versão global | Dá um destino neutro em vez de uma escolha arbitrária. |
| Arquivos não HTML (PDF) com versões por idioma | Cabeçalho HTTP Link: com as alternativas | Não há <head> para a anotação; o cabeçalho cumpre o mesmo papel. |
Pré-requisitos
- Matriz de URLs equivalentes por país e idioma, incluindo páginas ausentes e diferenças de catálogo.
- Códigos de idioma e região válidos, URLs com HTTP 200, indexabilidade e canonical coerente.
- Definição da fonte de implementação: HTML, cabeçalho HTTP ou sitemap XML, sem conflitos entre elas.
Passo a passo detalhado
- Monte matriz URL × mercado com equivalentes reais e status HTTP.
- Defina os códigos válidos de idioma e região para cada URL, incluindo uma opção neutra quando fizer sentido.
- Confirme que cada página de destino é acessível, indexável e tem canonical coerente com sua versão.
- Implemente alternates autorreferentes e recíprocos via HTML, cabeçalho HTTP ou sitemap.
- Inclua x-default somente quando houver destino adequado para usuários não segmentados.
- Rastreie cada cluster para encontrar destinos 404, ausência de retorno e conflitos de canonical.
- Compare resultados por mercado no Search Console e monitore mudanças após releases regionais.
Exemplos práticos e códigos
Exemplo ilustrativo: adapte ao contexto do seu projeto.
<link rel="alternate" hreflang="pt-BR" href="https://www.exemplo.com/br/produto/" />
<link rel="alternate" hreflang="es-CL" href="https://www.exemplo.com/cl/producto/" />
<link rel="alternate" hreflang="x-default" href="https://www.exemplo.com/" />Caso completo — sintoma, causa, correção e evidência: Cenário ilustrativo: um produto tem URLs pt-BR, es-CL e es-MX, mas a versão chilena declara canonical para a mexicana. O conjunto hreflang fica incoerente. Corrija a canonical chilena para sua URL própria se ela for indexável e distinta, inclua alternates recíprocos nas três e valide códigos, HTTP e equivalência do produto.
Contraexemplo: Exemplo incorreto: apontar es-CL para a home do Chile quando as demais versões apontam para uma página específica de produto.
Como validar a implementação
- Rastreie os pares com Screaming Frog ou um validador de hreflang.
- Confirme reciprocidade, códigos válidos e HTTP 200.
- Verifique que canonicals não apontam todas as regiões para uma única URL.
- Analise segmentação geográfica no desempenho de pesquisa.
Ferramentas recomendadas
- Screaming Frog ou Sitebulb — auditam clusters e reciprocidade; não traduzem conteúdo.
- Google Search Console — permite observar desempenho por país e página; não oferece garantia de segmentação.
- curl/DevTools — conferem alternates em cabeçalhos HTTP.
Erros comuns
- Relacionar páginas sem equivalência de conteúdo, como um produto e a home de outro país.
- Omitir o retorno recíproco ou a autorreferência, inclusive depois de migrar URLs de um mercado.
- Apontar a canonical de uma versão para outro mercado quando as duas deveriam ser indexadas separadamente.
Checklist de execução
Marque as etapas concluídas. O progresso fica salvo apenas neste navegador.
Referências oficiais
- Versões localizadas de páginas Google Search Central
- Sites multirregionais Google Search Central
Histórico de atualizações
- Revisão editorial das consultas rápidas e matrizes de decisão: x-default alinhado entre consulta e matriz (seleção de país ou versão global/principal); versões por idioma-região sem proibir o es genérico.
- Revisão final para publicação: exemplo isolado de cabeçalho Link removido dos exemplos (o exemplo completo para PDF está no aprofundamento) e erros comuns consolidados.
- Publicação após revisão técnica e editorial final (precisão, exemplos, referências oficiais e acessibilidade).
Conteúdos relacionados
Tag canonical: como evitar URLs duplicadas
Entenda a canonical, identifique duplicidades, escolha URLs preferenciais, corrija conflitos e valide a seleção do Google com exemplos práticos.
Migração de site sem perder sinais orgânicos
Planeje migrações com inventário de URLs, mapa de redirects, testes em homologação, monitoramento no Search Console e plano de reversão.