Hreflang: como indicar versões de idioma e região ao Google

Hreflang avisa ao Google que uma página tem versões em outros idiomas ou regiões. A documentação do Google Search Central, atualizada em 21 de setembro de 2026, aceita três métodos equivalentes.

Hreflang não ensina o Google a detectar idioma

O buscador pode até descobrir algumas variações sozinho, mas normalmente é melhor indicar explicitamente as páginas específicas de idioma ou região. A confusão é comum: a detecção de idioma é feita por algoritmos, não pelo hreflang nem pelo atributo lang do HTML, segundo a própria documentação.

Três cenários pedem hreflang

A documentação recomenda a anotação principalmente quando:

• o conteúdo principal fica em um único idioma e só o template é traduzido, como navegação e rodapé — caso comum em fóruns com conteúdo gerado por usuários;
• há pequenas variações regionais no mesmo idioma, como páginas em inglês para Estados Unidos, Reino Unido e Irlanda;
• o site é totalmente traduzido em vários idiomas, por exemplo com versões em alemão e inglês de cada página.

As versões localizadas só são consideradas duplicadas quando o conteúdo principal permanece sem tradução. Quando a dúvida for entre traduzir e consolidar, vale comparar hreflang e canonical em sites multilíngues.

HTML, HTTP e sitemap são equivalentes

Tags HTML, cabeçalhos HTTP e sitemap XML são equivalentes para o Google, e cada site pode escolher o mais conveniente. São as três formas documentadas de indicar versões de idioma e região. Usar os três ao mesmo tempo não traz benefício na Busca e tende a dificultar a manutenção.

Regras comuns aos três métodos

As regras abaixo valem para HTML, cabeçalho HTTP e sitemap XML:

• cada versão de idioma deve listar a si mesma e todas as outras;
• as URLs alternativas precisam ser totalmente qualificadas, incluindo http:// ou https:// — nunca //example.com/foo nem /foo;
• as URLs alternativas não precisam estar no mesmo domínio;
• quando existirem várias URLs para o mesmo idioma em regiões diferentes, convém oferecer também uma URL genérica para falantes daquele idioma sem região definida;
• se duas páginas não apontarem uma para a outra, as tags podem ser ignoradas — isso impede que um site externo crie arbitrariamente uma anotação se apresentando como alternativa;
• se o conjunto completo de links bidirecionais ficar difícil de manter, é possível omitir alguns idiomas em algumas páginas; o Google processará os que apontarem entre si. Ao expandir, priorize ligar as novas páginas de forma bidirecional ao idioma dominante.

HTML: um link para cada variante

No elemento <head>, adicione um <link rel="alternate" hreflang="..."> para cada variante, incluindo a própria página. O conjunto de links é idêntico em todas as versões.

<head>
  <title>Widgets, Inc</title>
  <link rel="alternate" hreflang="en-GB" href="https://en-gb.example.com/page.html" />
  <link rel="alternate" hreflang="en-US" href="https://en-us.example.com/page.html" />
  <link rel="alternate" hreflang="en" href="https://en.example.com/page.html" />
  <link rel="alternate" hreflang="de" href="https://de.example.com/page.html" />
  <link rel="alternate" hreflang="x-default" href="https://www.example.com/" />
</head>

Os links precisam estar dentro de um <head> bem formado. Se houver dúvida, a documentação sugere validar o HTML renderizado. Também não se deve combinar hreflang com outros atributos, como media, em um único <link>.

Cabeçalho HTTP: para arquivos que não são HTML

Para arquivos não HTML, como PDFs, o mesmo aviso pode ser enviado no cabeçalho Link da resposta GET. O formato lista cada versão entre < e >, separada por vírgula.

Link: <https://example.com/file.pdf>; rel="alternate"; hreflang="en",
      <https://de-ch.example.com/file.pdf>; rel="alternate"; hreflang="de-CH",
      <https://de.example.com/file.pdf>; rel="alternate"; hreflang="de"

O cabeçalho também deve incluir todas as versões da página, inclusive a solicitada. E precisa ser idêntico em todas as respostas.

Sitemap XML: o namespace xhtml é obrigatório

No sitemap, cada URL entra em um elemento <url> com <loc> e recebe um filho <xhtml:link rel="alternate" hreflang="..."> para cada variante, incluindo ela mesma. O namespace xhtml precisa ser declarado.

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://www.example.com/english/page.html</loc>
    <xhtml:link rel="alternate" hreflang="de" href="https://www.example.de/deutsch/page.html" />
    <xhtml:link rel="alternate" hreflang="de-CH" href="https://www.example.de/schweiz-deutsch/page.html" />
    <xhtml:link rel="alternate" hreflang="en" href="https://www.example.com/english/page.html" />
  </url>
</urlset>

Os elementos <xhtml:link> não contam para o limite de URLs do sitemap. As regras gerais de sitemaps continuam valendo; veja também o guia Sitemap XML: como criar e enviar ao Google.

Código de idioma primeiro, região depois

O valor do hreflang é formado por um código de idioma em ISO 639-1 e, opcionalmente, um código de região em ISO 3166-1 Alpha 2, separados por hífen. Só códigos presentes nessas listas são suportados: formatos como es-419 não são aceitos.

O valor é case-insensitive, mas a convenção é manter a região em maiúsculas, como em en-GB.

Não é permitido especificar o código de país sozinho. O primeiro código sempre representa o idioma, e o Google não deriva automaticamente o idioma a partir do país.

Para falantes de alemão, holandês e francês na Bélgica, os códigos corretos são de-BE, nl-BE e fr-BE. Usar somente be seria inválido, porque be é o código de idioma bielorrusso.

Também é possível usar um código de idioma isolado, como de para conteúdo em alemão independente de região.

Para variações de escrita, o script pode ser derivado da região, como em zh-TW. Também pode ser declarado explicitamente com ISO 15924: zh-Hant para chinês tradicional e zh-Hans para chinês simplificado. A combinação com região continua opcional, por exemplo zh-Hans-US.

x-default cobre quem não tem correspondência

O valor reservado x-default indica a página de fallback para usuários cujo idioma não corresponde a nenhuma das versões localizadas. Embora possa ser usado em qualquer página, foi desenhado para páginas seletoras de idioma ou região, onde funciona melhor.

Não há necessidade de informar um código de idioma para x-default, porque a página se destina justamente a quem não teve correspondência.

<link rel="alternate" href="https://example.com/en-gb" hreflang="en-GB" />
<link rel="alternate" href="https://example.com/en-us" hreflang="en-US" />
<link rel="alternate" href="https://example.com/country-selector" hreflang="x-default" />

Três erros que anulam o hreflang

Os três erros principais listados pela documentação são:

• Link de retorno ausente: se a página X aponta para a página Y, Y precisa apontar de volta para X. Sem essa reciprocidade, as anotações podem ser ignoradas.
• Código de idioma incorreto: informar apenas a região não é válido; o primeiro código deve identificar o idioma em ISO 639-1.
• Código de região incorreto: códigos reservados como EU, UN ou UK não têm efeito no Google Search.

Para validar ou gerar anotações, a documentação menciona duas ferramentas de terceiros. O Google não mantém nem verifica nenhuma delas: o gerador de tags hreflang de Aleyda Solis e a ferramenta de teste de tags hreflang da Merkle.

O que fazer agora

1. Liste todas as versões de cada página, incluindo a própria, e escolha um único método de implementação.
2. Confira se cada URL alternativa está totalmente qualificada, com https:// ou http://.
3. Verifique a reciprocidade: toda página que aponta para outra precisa ser apontada de volta.
4. Valide os códigos nas listas ISO 639-1 e ISO 3166-1 Alpha 2 e reserve o x-default para a página seletora.