Gerador de Tags Hreflang
Gere tags hreflang para um site multilíngue a partir de uma lista de pares de locale e URL. Gera tags <link> HTML, entradas de sitemap XML ou um cabeçalho HTTP Link, e sinaliza locales duplicados, códigos de idioma inválidos e URLs relativas.
Entrada
Um por linha: um código de idioma e, em seguida, a URL absoluta. Separados por vírgula, tabulação ou espaço.
Exibido para visitantes cujo idioma não corresponde a nenhum dos anteriores.
Use o formato de sitemap ou de cabeçalho quando não puder editar o head da página (por exemplo, em PDFs).
Reescreve en-us como en-US e zh-hant como zh-Hant. Os códigos não diferenciam maiúsculas de minúsculas, mas a grafia canônica é mais fácil de auditar.
Saída
Mais formas de usar esta ferramenta
API REST
curl -X POST https://api.iotools.cloud/v1/tool/hreflang-generator \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"pairs": "en-US, https://example.com/\nen-GB, https://examp…",
"xDefault": "https://example.com/",
"format": "html",
"normalize": "true"
}'Troque pela sua própria chave, da sua conta. Os campos da ferramenta viram o corpo da requisição — sem envelope.
Peça a um agente de IA
Use the IOTools `hreflang-generator` tool (Hreflang Tag Generator) on this input:
YOUR_INPUT_HERECole isto em qualquer agente conectado ao servidor MCP do IOTools e depois adicione sua entrada.
Widget para incorporar
<iframe
src="https://iotools.cloud/embed/hreflang-generator/"
width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
title="Gerador de Tags Hreflang — iotools.cloud"
sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
allow="clipboard-write"
style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>Coloque isso na sua própria página — grátis, sem chave, só um link de volta.
| Custo por chamada de API/MCP | A partir de 5 créditos |
|---|---|
| Precisa de mais créditos? | Ver preços |
Também disponível via
Guias
hreflang informa a um mecanismo de busca que duas URLs são a mesma página em idiomas diferentes, para que um visitante francês receba /fr/ em vez do original em inglês. Se estiver errado, a anotação é descartada silenciosamente — não há mensagem de erro; as páginas apenas continuam competindo entre si.
Cole seus pares de locale/URL e este gerador escreve a marcação e audita o conjunto ao mesmo tempo.
Como usar
Coloque uma alternativa por linha, com o código do idioma primeiro:
en-US, https://example.com/
en-GB, https://example.com/uk/
fr, https://example.com/fr/Vírgula, tabulação, ponto e vírgula ou espaços simples funcionam como separador. Adicione uma URL x-default para visitantes cujo idioma não corresponda a nada da lista, e escolha o formato de saída que você realmente consegue implantar:
- Tags
<link>HTML — a escolha usual, inserida no<head>de cada página listada. - Entradas de sitemap XML — um
<urlset>completo com filhos<xhtml:link>, um bloco<url>por locale. Melhor quando você tem muitas páginas e não quer inflar cada head. - Cabeçalho HTTP
Link:— a única opção para arquivos que não são HTML. Se você localiza PDFs, é assim que os anota.
Deixe Normalizar maiúsculas do locale ativado e en-us vira en-US, zh-hant vira zh-Hant. Os rastreadores não diferenciam maiúsculas de minúsculas, mas a grafia canônica torna um diff mais legível.
O que a validação detecta
O painel de notas sinaliza as falhas que produzem marcação com aparência válida:
- Locales duplicados — duas entradas
en-USinvalidam o conjunto inteiro, não apenas a duplicata. - Códigos de país usados como idiomas —
us,cn,jpegrnão são idiomas ISO 639-1, então essas tags são ignoradas por completo. - Códigos que significam outra coisa do que você pensa —
uké ucraniano, não Reino Unido;seé sami do norte, não Suécia;bré bretão, não Brasil. - URLs relativas — hreflang exige URLs absolutas e totalmente qualificadas.
- Dois locales compartilhando uma URL, o que geralmente significa que uma tradução não foi publicada.
- Uma única alternativa, que não descreve relação alguma.
Preciso de links de retorno?
Sim, e esse é o motivo mais comum de o hreflang não fazer efeito. Toda URL do conjunto precisa devolver o mesmo bloco, incluindo uma tag autorreferente apontando para si mesma. Se /fr/ lista a página em inglês, mas a página em inglês não lista /fr/, a anotação inteira é descartada. Como este gerador emite um bloco completo cobrindo todas as alternativas, você pode colar a saída idêntica em cada página do conjunto.
O idioma ou a região vem primeiro?
O idioma sempre vem primeiro: en-GB, nunca GB-en. A região é opcional — use fr puro quando uma única página em francês atender a todos os países francófonos, e fr-CA apenas quando você realmente tiver uma versão canadense separada.
Privacidade
Tudo roda no seu navegador. Suas URLs nunca são enviadas nem buscadas — a ferramenta lê apenas a lista que você cola e mais nada.
Ferramentas relacionadas
Montando o restante do head? O Gerador de Meta Tags HTML cuida de títulos, descrições e Open Graph. Para escolher a URL canônica única que essas alternativas devem apontar, use o Canonicalizador de URL; para envolver a saída do sitemap em um arquivo completo, veja o Gerador de Sitemap XML. Depois que as tags forem publicadas, use o Testador de Tags hreflang para rastrear as páginas ao vivo e confirmar que os links de retorno realmente resolvem.