Gerador de clusters de hreflang

Dados de exemplo — substitua pelos seus

Adicione uma linha para cada versão de idioma da mesma página. O idioma pode ser detectado pela URL, e cada página pode ter seu próprio x-default opcional.

hreflang	URL	x-default (opcional, por página)	Remover a linha

Adicionar x-default

Defina um modelo de URL por idioma com {path} como marcador e cole um caminho por linha.

hreflang	O modelo de URL	x-default o modelo de url (opcional, por página)	Remover a linha

Caminhos (um por linha) Adicionar x-default usando este modelo:

O que este resultado significa ↓

Adicione uma localidade e uma URL acima para ver a saída.

Executado inteiramente no seu navegador — nada do que você cola é enviado ou armazenado. Contadores anônimos de resultados por execução podem ser usados em pesquisas agregadas; URLs, domínios, IPs e identificadores nunca são incluídos, e nenhuma estatística é divulgada com menos de 100 execuções.

Verificar uma URL ao vivo

Busque uma página que você já publicou: lemos suas anotações hreflang ativas e depois buscamos cada alternativa declarada (até 25) para verificar os links de retorno e as autorreferências.

Comentários

As verificações são executadas em nosso servidor; buscamos a URL informada e não guardamos os resultados. Contadores anônimos de resultados por execução podem ser usados em pesquisas agregadas; URLs, domínios, IPs e identificadores nunca são incluídos, e nenhuma estatística é divulgada com menos de 100 execuções.

Relatório de exemplo para a ferramenta

Um site em inglês dos EUA e do Reino Unido, com uma alternativa genérica en e um x-default, gera tags no head como estas:

<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en" href="https://example.com/us/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />

…e, ao executar esse cluster no validador integrado, o resultado é:

Os códigos são normalizados automaticamente. Digite en-us ou en-US — o gerador sempre emite a região em maiúsculas (en-US), portanto erros de capitalização não viram um problema.
O en genérico en torna o resultado claro. Ele alcança falantes de inglês fora dos EUA e do Reino Unido que não corresponderiam a nada; consulte variantes regionais sem alternativa genérica.
x-default alcança todas as outras pessoas; consulte x-default ausente para ver o que acontece sem ele.
A bidirecionalidade não aparece nas tags de uma única página, mas este gerador emite o mesmo bloco completo em todas as páginas do conjunto; cada URL listada também aponta de volta para esta automaticamente.
Teste: cole en-uk em vez de en-gb e o validador aponta o erro e a correção; consulte o formato dos códigos.

Como usar a ferramenta

Adicione uma linha por página e uma coluna por idioma ou região; depois preencha cada URL.
Opcionalmente, defina um x-default por linha e importe um sitemap existente para criar um cluster.
Copie as tags do head, o XML do sitemap ou os cabeçalhos HTTP Link; cada página recebe um cluster bidirecional completo.
Cole a marcação publicada ou verifique uma URL para detectar erros comuns antes de publicar.

Como funciona (e como o hreflang quebra)

Use quando você controla os modelos HTML de páginas comuns.

Geralmente é a opção mais clara: renderize o mesmo cluster completo no head de cada página.

Use quando for difícil alterar os modelos ou quando muitas variantes de URL forem gerenciadas de forma centralizada.

Use entradas xhtml:link de forma consistente e mantenha o sitemap acessível aos rastreadores.

Use quando a alternativa for um arquivo que não seja HTML.

É a opção prática para arquivos sem head HTML. Evite misturar métodos sem um motivo.

hreflang informa aos mecanismos de busca quais versões de idioma ou região de uma página existem, para que cada pessoa receba a versão correta. Há três métodos equivalentes: tags <link rel="alternate"> no <head>, entradas xhtml:link em um sitemap XML ou cabeçalhos HTTP Link, a única opção para PDFs e outros arquivos não HTML. Escolha um método por página; misturar métodos pode criar conflitos.

As duas regras que quebram a maioria das implementações são: toda página deve incluir uma entrada autorreferente e cada par deve ser bidirecional — se A lista B, B precisa listar A de volta ou o par é ignorado. Como este gerador emite o cluster completo em cada página, ambas são atendidas automaticamente.

Variantes regionais sem alternativa genérica

Se você publicar en-US e en-GB sem o en genérico, pessoas que falam inglês na Austrália, Irlanda ou Índia não encontrarão correspondência e o Google escolherá por elas. Adicione uma entrada en genérica; ela pode apontar para a página correspondente tratada como padrão.

Ausência de x-default.

x-default nomeia a página para usuários que não correspondem a nenhum idioma declarado, normalmente um seletor de idioma ou sua versão principal. É opcional e esta ferramenta apenas avisa sobre sua ausência, mas é melhor explicitá-lo do que permitir que o algoritmo escolha.

Uma página independente de seleção de idioma também precisa das anotações: coloque nela o mesmo bloco de tags do head; a linha x-default é sua autorreferência e mantém o cluster bidirecional. No sitemap, uma URL de seletor que não seja uma página local recebe automaticamente sua própria entrada <url> anotada.

x-default também é uma anotação por página: páginas do mesmo cluster podem apontar para x-defaults diferentes — a página francesa para um seletor em francês e a inglesa para um seletor em inglês. Use a coluna x-default por linha; quando as páginas diferirem, a saída muda para um bloco por página e cada seletor distinto recebe sua própria entrada anotada no sitemap.

Os protocolos http/https misturados e as barras finais inconsistentes.

As URLs hreflang precisam corresponder exatamente à URL canonical. Se parte das entradas usar http:// ou remover a barra final para a qual seu site redireciona, esses alternativos passarão por redirecionamentos e o Google frequentemente os descartará. Use a forma final e canonical de cada URL.

Códigos de idioma obsoletos

Alguns códigos ISO 639-1 foram renomeados e permanecem em exportações antigas de sistemas de conteúdo: in → id (indonésio), iw → he (hebraico), ji → yi (iídiche). Os mecanismos de busca geralmente toleram as formas antigas, mas use os códigos modernos.

Formato dos códigos

Os valores são idioma ou idioma-REGIÃO: código de idioma ISO 639-1 de duas letras e, opcionalmente, região ISO 3166-1 alpha-2. A armadilha clássica é en-uk — o código regional do Reino Unido é GB. Subetiquetas de script como zh-Hant / zh-Hans também são válidas. Sublinhados (en_US) não são. A correspondência ignora maiúsculas e minúsculas; a capitalização é apenas cosmética.

Consulte códigos de idioma e região

Pesquise os códigos de idioma ISO 639-1 e de região ISO 3166-1 aceitos pelo gerador. Nomes antigos de idioma aparecem com a substituição correspondente.

Filtrar códigos

Idiomas da ferramenta (188)

aa ab ae af ak am an ar as av ay az ba be bg bh bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik in → id io is it iu iw → he ja ji → yi jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mo → ro mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu

Regiões da ferramenta (249)

ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

Metodologia da ferramenta.

A ferramenta constrói o cluster a partir de uma linha por URL e idioma, normaliza os subcódigos e emite o mesmo conjunto completo, incluindo autorreferências, para cada página. Depois aplica regras determinísticas a códigos, URLs, duplicatas, protocolos, barras finais, x-default e reciprocidade. Na verificação publicada, busca a URL informada e até 25 alternativos para comparar links de retorno, autorreferências e canonicalização. Tudo ocorre no navegador, exceto a solicitação opcional da verificação publicada.

Recursos da ferramenta

Gera um cluster completo e bidirecional para cada conjunto de páginas, incluindo autorreferências.
Exporta tags do head, XML de sitemap com divisão automática acima de 50.000 URLs, cabeçalhos HTTP Link e trechos para frameworks web.
Normaliza códigos de idioma e região e detecta sublinhados, códigos obsoletos e regiões inválidas.
Verifica idiomas e URLs duplicados, protocolos mistos, barras finais inconsistentes, falhas de reciprocidade e ausência de x-default.
Importa linhas CSV ou TSV ou entradas xhtml:link de um sitemap e executa a análise inteiramente no navegador.
Verifica uma URL publicada e até 25 alternativos declarados em busca de links de retorno e autorreferências.

Limitações da ferramenta

Ele roda no navegador; a entrada colada e a geração no dispositivo não consultam um banco de dados de pesquisa.
A verificação de uma URL publicada depende de a página estar acessível e é limitada a 25 alternativos e um corpo decodificado de 2 MiB.
O validador verifica o que você fornece; não confirma a indexação do Google, conteúdo privado ou se um mecanismo escolherá uma URL.
A divisão do sitemap vale para uma saída gerada acima de 50.000 URL; o arquivo baixado inclui o índice e todas as partes.

Perguntas frequentes da ferramenta

Onde ficam as tags hreflang: no head, no sitemap ou em um cabeçalho HTTP?

As três opções são equivalentes, mas escolha um único método por página. Use tags <link rel="alternate"> no head do HTML, entradas xhtml:link em um sitemap XML ou um cabeçalho HTTP Link — a única opção para arquivos que não são HTML, como PDFs. Misturar métodos na mesma página favorece conflitos.

O que é x-default e preciso usá-lo?

x-default indica a página que deve ser exibida para usuários que não correspondem a nenhuma das localidades declaradas — normalmente um seletor de idioma ou a versão principal. É opcional, mas é melhor declará-lo explicitamente do que deixar o algoritmo escolher; ele é recomendado para a maioria dos sites.

Por que minhas tags hreflang estão sendo ignoradas?

Quase sempre por um de três motivos: as anotações não são bidirecionais (a página A lista B, mas B não aponta de volta para A), uma página não tem sua entrada autorreferente ou as URLs não correspondem à forma canonical (por exemplo, http em vez de https ou uma barra final para a qual o site redireciona) e passam por redirecionamentos. Este gerador produz o grupo bidirecional completo com autorreferências para evitar as duas primeiras causas.

As tags hreflang e canonical entram em conflito?

Elas precisam estar alinhadas. Cada versão de idioma deve ter um canonical autorreferente (apontando para si mesma, não para outro idioma), e cada URL hreflang deve ser a forma canonical daquela página. Um hreflang que aponta para uma URL não canonical ou que redireciona costuma ser descartado.

en-uk é um valor hreflang válido?

Não. O código de região do Reino Unido é GB, então use en-gb. Os valores hreflang são formados por um código de idioma ISO 639-1 e um código de região ISO 3166-1 alpha-2 opcional; en-uk é o erro mais comum.

Próxima etapaSimulador de incidentes de SEO — practice the same investigation on labeled fixtures. Orientações disponíveis em inglês.

Problemas comuns e como corrigi-los

Erro O código de idioma é inválido Correção: Substitua a subtag de idioma por um código ISO 639-1 válido, como en, fr ou de.
Erro O código de região é inválido Correção: Substitua a subtag de região por um código ISO 3166-1 alpha-2 válido em maiúsculas, como US ou GB.
Erro hreflang usa sublinhado em vez de hífen Correção: Troque o sublinhado do código de localidade por um hífen, por exemplo, en_US por en-US.
Erro A localidade está duplicada Correção: Mantenha uma alternativa por valor de idioma e região e remova ou mescle a linha de localidade duplicada.
Aviso URL é atribuído para várias locales Correção: Atribua cada URL alternativa à sua localidade real e remova qualquer segunda localidade que aponte para a mesma página localizada.
Aviso x-default alternate é ausente Correção: Adicione uma alternativa x-default que aponte para o seletor de idioma neutro ou para a página padrão mais adequada a usuários sem correspondência.
Erro A URL alternativa é inválida Correção: Corrija a alternativa para uma URL http:// ou https:// válida, sem espaços nem caracteres malformados.
Erro A URL alternativa não é absoluta Correção: Expanda a alternativa relativa para sua URL canonical https:// completa, incluindo o nome do host e o caminho.