Como usar
- Adicione uma linha para cada versão de idioma ou região: o código (como de ou de-AT) e a URL completa em https:// dessa versão.
- Se quiser, adicione uma URL x-default para visitantes cujo idioma não esteja listado.
- Corrija os erros exibidos ao lado das linhas e escolha entre tags HTML, entradas de sitemap XML ou um cabeçalho HTTP.
- Copie o código e adicione o mesmo conjunto a todas as páginas listadas, para que cada página liste todas as versões, inclusive ela mesma.
Como funciona
hreflang informa aos mecanismos de busca quais URLs são versões no mesmo idioma ou em regiões diferentes de um mesmo conteúdo. Assim, por exemplo, uma pessoa que pesquisa na Áustria pode ver a página de-AT em vez da página de-DE. O valor é um código de idioma ISO 639-1, opcionalmente seguido por um código de região ISO 3166-1 alpha-2; uma região sem idioma (como “GB”) não é válida. Entre os erros comuns detectados pela ferramenta estão en-UK (o código correto é en-GB), regiões que não são países, como EU, e códigos duplicados. Os códigos são verificados com base nos dados de idiomas e regiões disponíveis no seu navegador.
As anotações devem ser bidirecionais e autorreferentes: cada página do conjunto deve listar todas as versões, inclusive ela mesma. Se a página em alemão apontar para a página em francês, mas a página em francês não apontar de volta, os mecanismos de busca poderão ignorar o par. x-default indica a página alternativa exibida para os demais usuários. Use URLs absolutas e aponte cada hreflang para a versão canônica da página, não para um redirecionamento ou uma página com uma tag noindex.
Há três maneiras equivalentes de publicar as anotações: elementos link no cabeçalho HTML, entradas xhtml:link em um sitemap XML ou um cabeçalho HTTP Link. Escolha um método para cada conjunto de páginas; não é necessário usar mais de um. hreflang é uma indicação para escolher entre versões, não um fator que melhora o posicionamento.
Exemplos
Site em inglês e alemão
As linhas en → https://example.com/ e de → https://example.com/de/ mais x-default → https://example.com/ geram três tags link. Tanto a página em inglês quanto a página em alemão devem incluir as três.
Espanhol para Espanha e México
Use es-ES e es-MX para as duas versões regionais e adicione uma versão es sem região (ou aponte es para uma delas) para incluir também falantes de espanhol de outros países.
Corrigir um erro comum
en-UK é sinalizado: UK não é o código ISO 3166-1 do Reino Unido. Altere para en-GB.
Perguntas frequentes
Preciso usar x-default?
É opcional, mas recomendado. Informa aos mecanismos de busca qual página exibir quando nenhum dos idiomas ou regiões listados corresponder ao usuário, como uma página global em inglês ou um seletor de idioma.
Posso usar uma região sem idioma, como hreflang="us"?
Não. O idioma é obrigatório; a região é opcional. “us” não é um código de idioma. Use en-US.
Devo usar tags HTML ou o sitemap?
As duas opções funcionam. Tags HTML são a opção mais simples para sites pequenos. Sitemaps mantêm o HTML das páginas menor e são mais fáceis de gerenciar quando há muitos idiomas. Cabeçalhos HTTP são usados principalmente em PDFs e outros arquivos que não são HTML.
Dois códigos de idioma podem apontar para a mesma URL?
Sim. Por exemplo, en-GB e en-IE podem apontar para a mesma página em inglês britânico. O que não é permitido é o mesmo código apontar para duas URLs diferentes.
Privacidade
Os códigos e as URLs são verificados e formatados no seu navegador. Nada é enviado nem armazenado.