Uma orientação rápida: esta página explica o que é hreflang, como usar a ferramenta acima, traz um exemplo prático, descreve os quatro erros que arruínam a maioria das implementações hreflang e mostra como esta ferramenta premium se diferencia das alternativas.
O que é um gerador de tags hreflang?
Um gerador de tags hreflang é uma ferramenta que produz as anotações de link rel="alternate" hreflang="..." que sites internacionais utilizam para indicar aos mecanismos de busca qual versão linguística e regional de uma página exibir para cada usuário. Ele transforma uma lista de URLs localizadas em tags <link> prontas para copiar e colar, um cabeçalho HTTP Link:, um sitemap XML com anotações xhtml:link ou dados estruturados JSON-LD — o formato que sua infraestrutura precisar.
Implementado corretamente, hreflang é o sinal mais forte que o Google possui para entender que duas páginas oferecem o mesmo conteúdo em idiomas diferentes. Implementado de forma incorreta, é a fonte mais comum de rankings internacionais quebrados. Esta ferramenta premium verifica suas entradas em busca dos três erros que destroem a maioria das configurações hreflang — links não recíprocos, autorreferências ausentes e mistura de HTTPS/HTTP — antes de entregar o resultado.
Como usar este gerador de tags hreflang
Siga estes cinco passos para criar um conjunto hreflang válido em menos de dois minutos:
- Liste cada URL localizada da sua página. Cole a URL absoluta HTTPS, o código de idioma ISO 639-1 (como
en,es,de) e um código de região ISO 3166-1 alfa-2 opcional (comoUS,GB,ES) para cada variante. O autocomplete integrado valida ambas as listas de códigos enquanto você digita. - Adicione uma URL x-default (recomendado). Esta é a página de fallback exibida quando nenhuma das suas versões linguísticas corresponde ao idioma do navegador do usuário. A maioria dos sites aponta para sua landing page em inglês ou para uma versão independente de idioma.
- Acompanhe o painel de validação em tempo real. Erros bloqueiam a geração de saída (URLs sem HTTPS, códigos ISO malformados, versões linguísticas duplicadas); avisos sinalizam problemas secundários como barras finais inconsistentes ou ausência de x-default. O painel indica exatamente qual linha precisa ser corrigida.
- Escolha seu formato de saída. Tags HTML
<link>vão no<head>da sua página. O cabeçalho HTTPLink:vai na configuração do seu servidor para respostas não HTML, como PDFs. O formato de sitemap XML é o preferido pelo Google para grandes sites multilíngues. JSON-LD é um formato de depuração e documentação que pode conviver com seus dados estruturados. - Copie ou baixe. Cada aba de saída tem seu próprio botão de copiar para a área de transferência e um botão de download com um nome de arquivo adequado (
hreflang.html,sitemap.xml, etc.). Seus dados nunca saem do seu navegador — esta ferramenta roda inteiramente no lado do cliente.
Carregar um exemplo
Clique em Carregar exemplo no painel de entrada para preencher a ferramenta com um cenário realista de e-commerce com três versões linguísticas (inglês EUA, espanhol Espanha, alemão Alemanha) e ver todos os formatos de saída preenchidos. O exemplo é um ótimo ponto de partida para adaptá-lo à sua própria estrutura de URLs.
Mergulho profundo: o que torna um conjunto hreflang correto
A maioria das auditorias de SEO internacional falha em três erros específicos. Este gerador de tags hreflang detecta os três — mas compreendê-los torna você mais ágil na hora de depurar configurações quebradas que você não criou.
Reciprocidade. Se a página A lista a página B como alternativa, a página B deve listar a página A como alternativa em retorno. Um link unidirecional não constitui uma relação hreflang; o Google o ignora silenciosamente. A reciprocidade é estrutural nesta ferramenta: cada URL do seu conjunto de entrada recebe alternativas referenciando todas as outras URLs, tornando impossível errar na reciprocidade.
Autorreferência. Cada URL deve incluir a si mesma em seu próprio conjunto hreflang. Uma página que diz "minha versão em espanhol está ali" sem dizer também "eu sou a versão em inglês" está malformada. Novamente, esta ferramenta gera a autorreferência automaticamente; você nunca precisa escrevê-la.
URLs absolutas HTTPS. URLs relativas (/en/page) e URLs HTTP (http://example.com/en/page) são descartadas silenciosamente pelos mecanismos de busca. Cada URL deve ser absoluta e usar HTTPS. A ferramenta rejeita entradas sem HTTPS no momento da geração e sinaliza inconsistências de protocolo durante a validação.
O quarto erro — menos frequente, porém mais difícil de depurar — são as barras finais inconsistentes. O Google trata https://example.com/en/page e https://example.com/en/page/ como duas URLs distintas, o que significa que um conjunto hreflang que misture ambas as formas funcionará apenas parcialmente. O painel de validação sinaliza a inconsistência de barras finais como um aviso para que você escolha uma convenção e a mantenha.
Erros comuns e como corrigi-los
Estes são os cinco erros que esta ferramenta detecta e que auditores encontram com mais frequência em configurações quebradas.
-
Misturar URLs HTTP e HTTPS. Se qualquer linha usa
http://, a ferramenta se recusa a gerar saída. Corrija alterando cada URL para a versão HTTPS que seu site realmente serve. Se seu site possui um redirecionamento legítimo de HTTP para HTTPS, use a URL de destino do redirecionamento, não a URL de origem. -
Usar
en_USem vez deen-US. A especificação hreflang usa um hífen entre idioma e região, não um underscore. A ferramenta normaliza automaticamente os códigos de idioma para minúsculas e os códigos de região para maiúsculas, e rejeita entradas que não correspondam aos formatos ISO de duas letras. -
Listar a mesma versão linguística duas vezes. Se duas linhas declaram
en-US, o Google não consegue decidir qual página é a versão canônica em inglês americano e escolhe arbitrariamente. A ferramenta bloqueia a geração quando há versões duplicadas e indica quais linhas estão em conflito. -
Esquecer o x-default. A ausência de x-default não é um erro de sintaxe, mas reduz a eficácia do hreflang. Usuários cujo cabeçalho Accept-Language não corresponde a nenhuma das suas versões declaradas verão a página que o resultado de busca exibir por padrão, que pode não ser sua melhor landing page. O painel de validação avisa sobre um x-default ausente quando você tem mais de duas linhas.
-
Confundir chinês tradicional e simplificado. O chinês é particularmente complicado:
zh-CNé simplificado (China continental),zh-TWé tradicional (Taiwan),zh-HKé tradicional (Hong Kong). Servir conteúdo simplificado emzh-TWou vice-versa é um sinal de qualidade que o Google percebe ao longo do tempo. Esta ferramenta valida os códigos ISO, mas não consegue inspecionar seu conteúdo real — você precisa verificar manualmente se o conteúdo corresponde ao código.
O que diferencia esta ferramenta
Quatro aspectos distinguem este gerador de tags hreflang premium das alternativas:
- Validação em tempo real. Cada tecla digitada é revalidada. Você vê os erros enquanto digita, não depois de clicar em "Gerar" e esperar pelo resultado.
- Quatro formatos de saída simultâneos. HTML, cabeçalho HTTP, sitemap XML e JSON-LD são todos gerados a partir do mesmo conjunto de alternativas. Troque de aba para copiar o que sua infraestrutura precisa — sem necessidade de escolher antecipadamente.
- Suporte a importação em massa. Cole um CSV de 10 000 linhas e a ferramenta processa fora da thread principal por meio de um Web Worker. A interface nunca trava, mesmo ao gerar saídas volumosas.
- URLs de estado compartilháveis. Clique em "Compartilhar link" para gerar uma URL que codifica o estado atual da ferramenta. Envie para um colega ou salve nos seus tickets — ao abrir o link, eles verão a mesma entrada.
Tudo roda no seu navegador. Não há cadastro, não há conta, não há paywall, não há limite de uso, não há servidor que veja suas URLs. A ferramenta é um recurso premium disponível para todo profissional de SEO internacional.