Gerador de hreflang — crie tags para sites multilíngues

Sem hreflang, o Google pode tratar suas páginas traduzidas como duplicadas e mostrar a versão no idioma errado na busca. Transforme um conjunto de URLs de idioma em marcação hreflang em três formas: tags <link>, cabeçalho HTTP Link e sitemap <xhtml:link>. Passos: cole cada URL de idioma com seu código, escolha uma forma e copie o trecho gerado. Cada URL recebe sua própria anotação de autorreferência, e um fallback x-default opcional pode ser adicionado. Roda inteiramente no seu dispositivo — nada é enviado. Exemplo: três versões de uma página em en, es e ja.

Como funciona

O gerador analisa cada linha em um código de idioma e uma URL, e então renderiza o mesmo conjunto de relações em três formas. A forma <link> vai no <head> de cada página. A forma de cabeçalho HTTP Link é enviada na resposta do servidor. A forma sitemap incorpora <xhtml:link> dentro de cada bloco <url>. Cada URL recebe uma anotação hreflang de autorreferência, e a entrada x-default opcional cobre visitantes cujo idioma não aparece na lista.

Regras usadas pelo gerador

Estas regras vêm do Google Search Central e do padrão BCP 47 de tags de idioma.

Cada versão de idioma deve incluir uma anotação hreflang de autorreferência que aponte para sua própria URL. Omiti-la enfraquece o sinal.
Cada URL deve aparecer a partir de todas as versões: o conjunto completo de alternativas está em cada página, não apenas em uma direção.
Os códigos de idioma usam BCP 47: um idioma de duas letras, opcionalmente uma região (en-US) e opcionalmente um sistema de escrita (zh-Hans). x-default é o código especial de fallback.
x-default aponta para a página mostrada quando nenhum idioma listado coincide, por exemplo uma raiz em inglês. O Google pode usá-la como fallback para todos os idiomas não detectados.
Escolha uma única forma de entrega por conjunto: as tags <link> no HTML, o cabeçalho HTTP Link ou xhtml:link no sitemap. Não misture formas no mesmo conjunto, ou os sinais podem se contradizer.

Exemplo

A amostra lista três versões de uma página: https://example.com/ (en), https://example.com/es/ (es) e https://example.com/ja/ (ja). As tags <link> geradas incluem autorreferências para cada idioma, além de um x-default opcional apontando para a raiz em inglês.

Bons usos

Lançar um site multilíngue: gere as tags <link> uma vez por template e verifique se cada versão de idioma lista o conjunto completo.
Após uma reestruturação do site, regenere a marcação para que o mapeamento de URLs permaneça consistente entre idiomas.
Quando os resultados de busca mostram o idioma errado, verifique se existem autorreferências e x-default e se as URLs apontam para páginas canônicas.

Frequently asked questions

Qual das três formas devo usar?

Use as tags <link> quando puder editar o HTML. Use o cabeçalho HTTP Link quando as páginas forem servidas por um servidor que você controla e for difícil mudar o HTML. Use a forma sitemap se preferir mantê-lo no sitemap XML.

Quando devo adicionar x-default?

x-default diz ao Google qual versão mostrar quando o idioma do visitante não coincide com nenhum código listado. Adicione-o quando tiver uma raiz ou página de fallback, geralmente em inglês.

Toda URL precisa de uma hreflang de autorreferência?

Sim. Cada versão de idioma deve incluir sua própria URL no conjunto, com uma hreflang de autorreferência apontando para si mesma. O Google usa o conjunto completo para escolher a página certa por idioma.

Qual formato de código de idioma é válido?

Códigos BCP 47: um idioma de duas ou três letras, opcionalmente uma região (en-US) e opcionalmente um sistema de escrita (zh-Hans). O idioma em minúsculas, e não invente códigos como «en-us-en».

Hreflang vai no <head> ou no sitemap?

Ambos funcionam, mas use uma única forma consistente por conjunto de páginas. As tags <link> ficam no <head>, o cabeçalho HTTP Link é enviado com a resposta e o sitemap usa blocos xhtml:link.

Minhas URLs são enviadas para algum lugar?

Não. O gerador roda inteiramente no seu navegador e nada é enviado.

Dúvidas ou feedback

Algo pouco claro, quebrado ou faltando? Escreva abaixo — lemos cada mensagem sobre estas ferramentas.