NeovaPlataforma avançada de SEO

Verificador de hreflang: como validar as tags hreflang e corrigir os erros

O hreflang diz aos buscadores qual versão de idioma ou região de uma página mostrar para quem. A ideia é simples. A implementação é frágil: cada página precisa listar todas as versões, cada versão precisa listá-la de volta, e um código errado ou uma URL com redirecionamento pode deixar um conjunto inteiro pouco confiável. Um verificador de hreflang lê tudo de uma vez.

SEO internacionalverificador de hreflangAtualizado em 21 de novembro de 2026Pela equipe da Neova

O que um verificador de hreflang faz

As tags hreflang de uma única página dizem muito pouco. Os erros que importam só aparecem quando você compara as páginas entre si: a página A lista a página B, mas a página B lista a página A? B responde 200? B é o próprio canonical? É por isso que um validador de hreflang para uma URL serve para verificações pontuais, enquanto um crawler é o verificador de hreflang para um site inteiro.

Uma verificação completa lê as tags de cada página, segue cada destino e responde quatro perguntas para cada conjunto:

  1. Todos os códigos são válidos?
  2. Cada página lista a si mesma e todas as outras versões?
  3. Cada destino retorna o link?
  4. Cada destino é uma URL indexável, com canonical para si mesma, que responde 200?

Como as tags hreflang funcionam

O guia do Google sobre versões localizadas das suas páginas descreve três formas de declarar o hreflang. Escolha uma por conjunto.

MétodoPáginas HTMLPDFs e arquivosFica em
Tags link✓–Head do HTML
Cabeçalho HTTP Link✓✓Resposta do servidor
XML Sitemap✓✓Arquivo de sitemap

1. Tags link no head do HTML

<link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="en-gb" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />

As mesmas quatro linhas vão nas quatro páginas, inclusive na x-default.

2. O cabeçalho HTTP Link

Útil para PDFs e outros arquivos que não têm head HTML:

Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
      <https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"

3. O XML Sitemap

<url>
  <loc>https://example.com/en-us/pricing/</loc>
  <xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
  <xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
</url>

O sitemap precisa do namespace xhtml declarado no elemento urlset, e cada entrada url repete o conjunto completo. Os sitemaps tiram conjuntos grandes do head da página, mas é fácil esquecê-los quando as páginas mudam.

As regras que todo conjunto de hreflang precisa seguir

  • Autorreferência. O Google diz que cada versão precisa listar a si mesma, além de todas as outras versões.
  • Links de retorno. Se a página A aponta para a página B, B precisa apontar de volta para A. O Google diz que, se duas páginas não apontam uma para a outra, as tags podem ser ignoradas.
  • URLs completas. https://example.com/de/, não /de/.
  • Destinos saudáveis. Cada destino deve responder 200, ser indexável e ser o próprio canonical. Uma tag que aponta para um redirecionamento, um 404 ou uma página noindex é um sinal que os buscadores precisam contornar.
  • A página equivalente. A página de preços em alemão deve apontar para a página de preços em francês, não para a home em francês.

Os códigos seguem padrões fixos. O Google os lista no seu guia de versões localizadas:

CódigoStandardExemploVálido
IdiomaISO 639-1de, pt✓
Idioma e regiãoISO 3166-1 Alpha 2de-at, pt-br✓
Idioma e escritaISO 15924zh-Hant✓
Só a regiãonenhumus–
Reino UnidoGB, não UKen-uk–
Alternativa padrãoValor reservadox-default✓

x-default: a versão alternativa padrão

x-default é um valor reservado para a página a mostrar quando nenhum outro idioma ou região do conjunto corresponde ao visitante. O Google o sugere para páginas de seleção de idioma e para páginas que redirecionam os visitantes conforme o idioma ou a localização.

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

É opcional, mas uma boa ideia na home e em qualquer página com seletor de idioma. Como qualquer outro destino, a URL x-default deve responder 200, ser indexável e ser o próprio canonical, e todas as páginas do conjunto devem indicar o mesmo x-default. Um deslize comum é apontar o x-default para uma URL que redireciona os visitantes por localização e deixar esse redirecionamento terminar em um erro.

Os erros de hreflang mais comuns

ErroComo apareceCorreção
Sem link de retornode omite en-usUma lista compartilhada por conjunto
Sem autorreferênciaA página omite a si mesmaAdicione a própria URL
Código de região erradoen-uken-gb
Região sem idiomahreflang="us"en-us
URL relativa/de/URL https completa
Destino redireciona ou dá erroURL francesa faz 301URL final
Destino tem canonical para outra URLURL com parâmetroURL canônica
Um código, duas URLsDuas páginas marcadas como deUma URL por código
Tags fora do headScript encerra o head antes da horaMova para cima, ou use o cabeçalho
Idioma divergentehreflang fr, html lang enSiga o idioma do texto da página

O guia de implementação de hreflang e SEO internacional do SEO ProCheck aprofunda cada um desses casos.

Hreflang e canonicals

As tags hreflang e canonical trabalham juntas e se quebram com facilidade. Cada versão de idioma deve ser o próprio canonical. Se a página em alemão indica a página em inglês como canonical, você está dizendo aos buscadores que a página em alemão é uma duplicata, o que vai contra o hreflang dela. Um canonical aponta dentro de um idioma; o hreflang aponta entre idiomas.

Verifique também se cada URL de um conjunto de hreflang é a versão canônica: mesmo protocolo, mesmo host, mesma barra final. Um conjunto que mistura URLs http e https, ou URLs com e sem barra, falha na verificação de link de retorno mesmo quando as páginas estão certas, porque as URLs não batem exatamente.

Como verificar o hreflang de um site inteiro

  1. Rastreie todas as versões de idioma. Se cada idioma fica no próprio domínio ou subdomínio, inclua todos no crawl, ou os links de retorno não podem ser verificados.
  2. Leia o hreflang de todos os métodos que você usa: o head do HTML, o cabeçalho HTTP Link e os sitemaps. Um conjunto declarado de duas formas é um conjunto que pode discordar de si mesmo.
  3. Valide os códigos antes de tudo. Um código errado repetido por um template pode afetar milhares de páginas.
  4. Verifique links de retorno e autorreferências em cada página.
  5. Verifique a saúde dos destinos: status, indexabilidade e canonical de cada destino.
  6. Procure conjuntos ausentes: páginas com equivalentes em outros idiomas mas sem nenhum hreflang.
  7. Corrija no nível do template ou do plugin, não página por página, e depois rastreie de novo.

Fazemos isso no nosso próprio site. O neova.app roda em 15 idiomas. Na nossa revisão de SEO de 20 de novembro de 2026, os XML Sitemaps listavam 1.358 URLs, e todos os links de hreflang tinham retorno: totalmente recíprocos. Com 15 versões, cada página lista 15 URLs, inclusive ela mesma, e cada uma delas precisa listá-la de volta. Gere todas as tags de um conjunto a partir de uma lista compartilhada, e os links de retorno vêm junto.

Os conjuntos de hreflang são o passo 12 do checklist de auditoria de SEO técnico. Se as suas versões de idioma redirecionam os visitantes, leia também o guia de cadeias de redirecionamento.

Verifique o hreflang com a Neova

A categoria Internacional da Neova mostra as versões de idioma e região de cada página e se elas apontam umas para as outras. Ela lê o hreflang do head do HTML e do cabeçalho HTTP Link, acrescenta as colunas Idiomas do hreflang e Destinos do hreflang a cada página HTML e confere o html lang com o hreflang e com o próprio texto da página. Algumas das verificações:

Cada sinalização diz por que importa, como corrigir e a sua fonte, e todas as tabelas exportam para CSV ou Excel para o desenvolvedor que corrige o template. A Neova executa as 694 verificações em todos os planos, inclusive o Free:

Neova
Roda em
Verificações694
Plano gratuito1.000 URLs por crawl
Idiomas da interface15

Mac significa Apple silicon; no navegador é a Neova Online, com a mesma conta. Veja os Recursos, os Preços ou baixe a Neova.

Perguntas

O que é um verificador de hreflang?

Uma ferramenta que lê as tags hreflang de um site e as confere entre si: códigos de idioma e região válidos, autorreferências, links de retorno, x-default e se cada destino responde 200, é indexável e é o próprio canonical.

O que são links de retorno do hreflang?

Se a página A lista a página B como alternativa, a página B precisa listar a página A também. O Google diz que, quando duas páginas não apontam uma para a outra, as tags hreflang delas podem ser ignoradas.

O x-default é obrigatório?

Não, é opcional. É recomendado para páginas de seleção de idioma, homes e páginas que redirecionam os visitantes por idioma ou localização, para que os buscadores saibam qual versão mostrar quando nada mais corresponde.

Devo usar en-uk ou en-gb?

en-gb. A parte da região é um código de país ISO 3166-1 Alpha 2, e o código do Reino Unido é GB. en-uk não é um valor válido. Mais respostas assim estão no FAQ de hreflang e SEO internacional do SEO ProCheck.

Qual método de hreflang é o melhor?

Qualquer um dos três funciona para o Google: tags link no head do HTML, o cabeçalho HTTP Link ou o XML Sitemap. Use um método por conjunto. As tags link são as mais fáceis de verificar, o cabeçalho serve para PDFs e os sitemaps tiram conjuntos grandes da página.

Leve isto com você

Os links dos assistentes abrem com uma pergunta sobre esta página já escrita.

Rastreie seu site com a NeovaO plano Free roda todas as verificações no Mac, Windows e Linux. Sem cartão de crédito.

Continue lendo