ASM Digital
Glossário

O que é hreflang? Como indicar versões de idioma e país ao Google

7 de outubro de 2026Última atualização em 7 de novembro de 20266 min de leitura

Hreflang é um atributo HTML que informa ao Google quais páginas do site são versões da mesma página em outros idiomas ou para outros países. Com ele, o buscador mostra a versão em português do Brasil para quem pesquisa no Brasil e a versão em inglês para quem pesquisa nos Estados Unidos, em vez de escolher uma delas ao acaso.

Sem hreflang, um site com versões pt-BR e pt-PT corre o risco de mostrar a página de Portugal para o público brasileiro, com preços em euro e vocabulário diferente. Nos dados do SE Ranking para o Brasil, "hreflang" tem 140 buscas por mês, quase sempre de quem está colocando um site no ar em mais de um idioma.

Como funciona o hreflang

Cada versão da página declara todas as versões existentes, incluindo ela mesma, com uma linha no <head>. Para um site com Brasil, Portugal e Estados Unidos, as três páginas trazem o mesmo bloco:

<link rel="alternate" hreflang="pt-BR" href="https://site.com/br/" />

<link rel="alternate" hreflang="pt-PT" href="https://site.com/pt/" />

<link rel="alternate" hreflang="en-US" href="https://site.com/us/" />

<link rel="alternate" hreflang="x-default" href="https://site.com/" />

O valor do atributo combina o código do idioma, no padrão ISO 639-1 (pt, en, es), com o código opcional do país, no padrão ISO 3166-1 Alfa-2 (BR, PT, US). O país sozinho não vale: BR não funciona, pt-BR sim.

O x-default indica a página para quem não se encaixa em nenhuma das versões, como um seletor de idioma ou a versão internacional em inglês.

As três formas de implementar

  1. Tags no HTML, como no exemplo acima. É a forma mais comum em sites com poucas versões.
  2. Cabeçalho HTTP Link, usado para arquivos sem HTML, como PDFs.
  3. Sitemap XML, com um elemento xhtml:link para cada versão dentro de cada URL. É a melhor opção para sites grandes, porque tira o peso do código da página. O guia de sitemaps mostra a estrutura do arquivo.

Escolha uma forma e mantenha só ela. Misturar métodos aumenta a chance de conflito entre as declarações.

Por que o hreflang importa para SEO

  • Entrega a versão certa ao público certo. O usuário cai na página com o idioma, a moeda e o frete do país dele, o que reduz o abandono.
  • Evita disputa entre versões parecidas. Páginas em pt-BR e pt-PT têm textos quase iguais. Com hreflang, o Google entende que elas formam um grupo e não as trata como conteúdo duplicado concorrendo pela mesma busca.
  • Organiza sites internacionais. Na indexação, o Google descobre as versões alternativas pelas declarações e entende a relação entre elas.

O Google trata o hreflang como um sinal, não como uma ordem. Ele também considera o idioma do conteúdo e outros fatores. Por isso, o texto de cada versão precisa estar de fato no idioma declarado.

Como implementar e verificar o hreflang

  1. Mapeie as versões em uma planilha: uma linha por página e uma coluna por idioma ou país, com a URL de cada versão.
  2. Confira que toda URL responde 200. Uma versão que devolve 404 ou redirecionamento quebra o grupo. Veja o status code HTTP de cada endereço antes de publicar.
  3. Inclua a autorreferência. Cada página lista a si mesma, além das outras.
  4. Garanta a reciprocidade. Se a página A aponta para B, B precisa apontar de volta para A. Sem o retorno, o Google ignora a declaração.
  5. Use URLs absolutas, com https:// e domínio completo.
  6. Alinhe com o canonical. Cada versão tem canonical para ela mesma. O guia de rel canonical explica a regra.
  7. Audite o resultado. O Screaming Frog tem uma aba Hreflang que aponta retorno ausente, código inválido e URL sem 200. No WordPress, plugins de tradução como WPML e Polylang geram as tags automaticamente.

Um exemplo: uma loja de cosméticos abre a operação em Portugal em loja.com/pt/ e mantém o Brasil em loja.com/. Semanas depois, consumidores portugueses chegam pelo Google à página brasileira, com preço em real. A auditoria mostra hreflang só nas páginas de Portugal, sem retorno nas brasileiras, e o código pt-PT escrito como pt-PO, um código de país que não existe. A correção é publicar o bloco completo nas duas versões, corrigir o código e reenviar o sitemap.

Se o seu site tem mais de um idioma e você quer saber se o Google entende cada versão, o diagnóstico de SEO gratuito da ASM Digital confere as declarações de hreflang.

Erros comuns

  • Código de país errado. O Reino Unido é en-GB, não en-UK. Códigos inválidos são ignorados.
  • Falta de retorno entre as páginas. A página de Portugal aponta para a do Brasil, e a do Brasil não aponta de volta. O par inteiro é ignorado.
  • Canonical apontando para outra língua. Se a versão em português tem canonical para a versão em inglês, o Google trata a versão em inglês como principal e deixa a página em português fora dos resultados.
  • Redirecionar automaticamente pelo IP ou pelo idioma do navegador. O Googlebot rastreia principalmente a partir dos Estados Unidos e acaba sem acesso às outras versões. Ofereça um seletor de idioma em vez de forçar o redirecionamento.
  • Declarar versões que não existem. Apontar para traduções ainda não publicadas gera links quebrados no grupo.

Hreflang vs canonical

Os dois lidam com páginas parecidas, mas resolvem problemas diferentes. O canonical diz qual página é a principal entre cópias da mesma versão e concentra os sinais nela. O hreflang diz que cada versão é válida para um público e pede que o Google mostre a certa. Em um site internacional, os dois trabalham juntos: canonical para si mesma e hreflang para as irmãs. A estrutura de URL com pastas por país, como /br/ e /pt/, facilita os dois.

Perguntas frequentes

Hreflang é obrigatório para sites em mais de um idioma?

Não é obrigatório, mas é a forma que o Google recomenda para indicar as versões. Sem ele, o Google tenta deduzir a relação entre as páginas, e em idiomas parecidos, como português do Brasil e de Portugal, a escolha nem sempre é a certa.

Preciso de hreflang se o site tem um idioma só?

Não. O hreflang só faz sentido quando existem versões alternativas da mesma página. Um site apenas em português do Brasil não precisa da tag.

Qual a diferença entre pt e pt-BR no hreflang?

pt atende a qualquer falante de português, em qualquer país. pt-BR atende ao português do Brasil. Se o site tem uma versão para o Brasil e outra para Portugal, use pt-BR e pt-PT. Se tem uma única versão em português, pt basta.

O hreflang melhora o ranqueamento?

Ele não aumenta a posição de uma página. O ganho está em fazer a versão certa aparecer para cada país, o que melhora cliques e conversões no mercado de destino.

Termos relacionados

Vai levar o site para outros países sem confundir o Google? Conheça o SEO técnico da ASM Digital.

← Voltar ao blog