Como usar
- Digite uma linha por versão de idioma em Versões de idioma: o código, uma barra vertical e o endereço completo.
- Se você tem um seletor de idioma ou uma página padrão, digite o endereço dela em Endereço de reserva (x-default).
- Leia Conferência das linhas. Quando ela disser que todas as versões são válidas, copie os elementos link, o sitemap ou o cabeçalho.
- Coloque o mesmo conjunto em todas as páginas e confira se cada versão aponta de volta para todas as outras.
Como os códigos são conferidos
A parte do idioma precisa ser um código de duas letras ISO 639-1: a lista da Biblioteca do Congresso tem 183 deles. A região opcional precisa ser um código ISO 3166-1 alfa-2 atribuído oficialmente, como GB ou TW. O guia do Google diz que só esses dois padrões são aceitos e que o idioma vem primeiro, então uma região sozinha, como GB, é recusada.
Uma parte de script, como Hant ou Hans, precisa ter quatro letras. O guia do Google diz que os scripts são dados pela ISO 15924; esta ferramenta confere a forma do script, e não a lista completa. Os códigos não diferenciam maiúsculas de minúsculas, por isso a ferramenta escreve o idioma em minúsculas, a região em maiúsculas e o script com a inicial maiúscula.
- en-uk é recusado porque UK é um código reservado; o Reino Unido é GB, então a ferramenta sugere en-GB.
- iw, in e ji foram trocados em 1989 por he, id e yi, então a ferramenta sugere esses códigos.
- Códigos que não correspondem a nada, como xx, eng ou en_US, são recusados com o número da linha.
Três formas de enviar o mesmo conjunto
O Google lista três métodos: elementos link no head do HTML, cabeçalhos HTTP e um sitemap XML. O Google diz que os três são equivalentes, então escolha o que for mais fácil de manter. A forma de sitemap precisa do namespace xhtml, e cada entrada url lista todas as alternativas, inclusive ela mesma.
O método do cabeçalho HTTP é descrito para a resposta GET de qualquer página; o Google o chama útil para arquivos que não são HTML, como PDFs, e os exemplos dele são PDFs. Para uma página web, os elementos link ou o sitemap são a escolha usual. O Google também diz que o cabeçalho Link devolvido para cada versão de uma página é idêntico, por isso esta ferramenta escreve um só valor para o conjunto inteiro.
Links de retorno e x-default
Cada versão precisa listar a si mesma e todas as outras versões, e cada página precisa apontar de volta. O Google diz (tradução livre): "Se duas páginas não apontarem uma para a outra, as tags serão ignoradas." Quando um conjunto é difícil de manter completo, o Google diz que você pode omitir alguns idiomas em algumas páginas, e ele ainda processa os pares que apontam um para o outro.
x-default nomeia a página de reserva para os idiomas que não correspondem a nenhuma das suas versões. O Google a recomenda para páginas de seletor de idioma, e ela é escrita sem código de idioma.
Exemplo resolvido: três versões e uma reserva
As linhas en | https://example.com/en/, en-GB | https://example.com/en-gb/ e tr | https://example.com/tr/, com https://example.com/ como reserva, formam quatro alternativas. Cada página do grupo recebe os mesmos quatro elementos link, e o sitemap tem uma entrada url para cada uma das três páginas.
Cada entrada url lista as quatro alternativas. A linha de estado diz 3 versões de idioma, todas válidas, porque a reserva não é uma versão de idioma.
| Saída | Quantidade | Detalhe |
|---|---|---|
| Elementos link | 4 | hreflang="tr" href="https://example.com/tr/" |
| Entradas url do sitemap | 3 | cada uma lista 4 alternativas, com x-default |
| Valores do cabeçalho Link | 1 | o mesmo valor em cada página, com 4 alternativas |
| Versões de idioma | 3 | estado: 3 versões de idioma, todas válidas |
Perguntas frequentes
Quais códigos são válidos?
Um código de idioma da ISO 639-1, como en, tr ou zh, pode ser seguido de um script de quatro letras, como Hant, e de uma região ISO 3166-1, como GB ou TW. Os códigos não diferenciam maiúsculas de minúsculas, e a ferramenta os escreve na forma padrão.
Por que en-uk é informado como erro?
UK é um código reservado na ISO 3166-1, e o guia do Google diz que UK no hreflang não tem efeito. O código atribuído ao Reino Unido é GB, então a tag correta é en-GB.
Preciso de uma linha x-default?
Não, é opcional. O Google chama x-default de reserva para os idiomas que não correspondem a nenhuma das suas versões, e o recomenda para seletores de idioma. A ferramenta só o acrescenta quando você digita um endereço.
Cada página precisa listar o conjunto inteiro?
Cada versão precisa listar a si mesma e todas as outras. O Google diz que as tags são ignoradas quando duas páginas não apontam uma para a outra, mas também diz que você pode omitir um idioma em algumas páginas e que ele ainda processa os pares que se apontam.
Por que a ferramenta aceita só endereços https?
Ela aceita endereços https absolutos, que a maioria dos sites usa hoje. O Google exige endereços completos, com o método de transporte, então um site que ainda roda em http simples precisa escrever as anotações à mão.
O método do cabeçalho HTTP é para páginas web?
O Google o descreve para a resposta GET de qualquer página e o chama útil para arquivos que não são HTML, como PDFs. Para páginas web, os elementos link ou o sitemap são a escolha usual.
A ferramenta envia os meus endereços para algum lugar?
Não. O resultado é montado no seu navegador a partir do texto que você digita, e nada é enviado a um servidor.
Fontes
- Google Search Central: versões localizadas e hreflang (em inglês)
- Biblioteca do Congresso: lista de códigos ISO 639-2 com os códigos ISO 639-1 (em inglês)
- Wikipédia (em inglês): ISO 639-1 (183 códigos registrados)
- Wikipédia (em inglês): List of ISO 639 language codes (os códigos mudaram em 1989)
- Wikipédia (em inglês): ISO 3166-1 alfa-2 (códigos atribuídos oficialmente; UK é reservado)
- Sitemaps.org: protocolo, escape de entidades (em inglês)
Números e texto verificados pela última vez em terça-feira, 10 de novembro de 2026.