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.
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:
- Todos os códigos são válidos?
- Cada página lista a si mesma e todas as outras versões?
- Cada destino retorna o link?
- 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étodo | Páginas HTML | PDFs e arquivos | Fica 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ódigo | Standard | Exemplo | Válido |
|---|---|---|---|
| Idioma | ISO 639-1 | de, pt | ✓ |
| Idioma e região | ISO 3166-1 Alpha 2 | de-at, pt-br | ✓ |
| Idioma e escrita | ISO 15924 | zh-Hant | ✓ |
| Só a região | nenhum | us | – |
| Reino Unido | GB, não UK | en-uk | – |
| Alternativa padrão | Valor reservado | x-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
| Erro | Como aparece | Correção |
|---|---|---|
| Sem link de retorno | de omite en-us | Uma lista compartilhada por conjunto |
| Sem autorreferência | A página omite a si mesma | Adicione a própria URL |
| Código de região errado | en-uk | en-gb |
| Região sem idioma | hreflang="us" | en-us |
| URL relativa | /de/ | URL https completa |
| Destino redireciona ou dá erro | URL francesa faz 301 | URL final |
| Destino tem canonical para outra URL | URL com parâmetro | URL canônica |
| Um código, duas URLs | Duas páginas marcadas como de | Uma URL por código |
| Tags fora do head | Script encerra o head antes da hora | Mova para cima, ou use o cabeçalho |
| Idioma divergente | hreflang fr, html lang en | Siga 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
- 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.
- 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.
- Valide os códigos antes de tudo. Um código errado repetido por um template pode afetar milhares de páginas.
- Verifique links de retorno e autorreferências em cada página.
- Verifique a saúde dos destinos: status, indexabilidade e canonical de cada destino.
- Procure conjuntos ausentes: páginas com equivalentes em outros idiomas mas sem nenhum hreflang.
- 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:
- Falta o link de retorno do hreflang e Falta a autorreferência do hreflang
- Código de idioma do hreflang inválido e Código de país do hreflang inválido
- Hreflang aponta para uma URL não 200 e Hreflang aponta para uma URL com canonical para outra
- Destino padrão do hreflang quebrado, com noindex, com canonical para outra URL ou inconsistente
- Hreflang aponta para a raiz de um idioma, não para a URL equivalente
- Hreflang e html lang discordam sobre o idioma
- Falta hreflang onde existem equivalentes em outros idiomas
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ções | 694 |
| Plano gratuito | 1.000 URLs por crawl |
| Idiomas da interface | 15 |
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.