O documento não tem um hreflang válido

Muitos sites oferecem diferentes versões de uma página com base no idioma ou na região do usuário. Os links hreflang informam aos mecanismos de pesquisa os URLs de todas as versões de uma página para que eles possam exibir a versão correta para cada idioma ou região.

Como a auditoria de hreflang do Lighthouse falha

O Lighthouse sinaliza links hreflang incorretos:

Auditoria do Lighthouse mostrando links hreflang incorretos

O Lighthouse verifica se há links hreflang no head da página e nos cabeçalhos de resposta.

Em seguida, o Lighthouse verifica os códigos de idioma válidos nos links de hreflang. O Lighthouse relata todos os links do hreflang com códigos de idioma inválidos.

O Lighthouse não verifica os códigos de região nem seu sitemap.

Como definir um link hreflang para cada versão de uma página

Digamos que você tenha três versões de uma página:

  • Uma versão em inglês em https://example.com
  • Uma versão em espanhol em https://es.example.com
  • Uma versão em alemão em https://de.example.com

Há três maneiras de dizer aos mecanismos de pesquisa que essas páginas são equivalentes. Escolha o método mais fácil para sua situação.

Opção 1:adicionar links hreflang ao <head> de cada página:

<link rel="alternate" hreflang="en" href="https://example.com" />
<link rel="alternate" hreflang="es" href="https://es.example.com" />
<link rel="alternate" hreflang="de" href="https://de.example.com" />

Cada versão de uma página precisa estar vinculada a todas as outras versões, incluindo ela mesma. Caso contrário, os mecanismos de pesquisa podem ignorar os links hreflang ou interpretá-los incorretamente.

Para páginas que permitem aos usuários selecionar o idioma, use a palavra-chave x-default:

<link rel="alternate" href="https://example.com" hreflang="x-default" />

Opção 2:adicionar cabeçalhos Link à sua resposta HTTP:

Link: <https://example.com>; rel="alternate"; hreflang="en", <https://es.example.com>;
rel="alternate"; hreflang="es", <https://de.example.com>; rel="alternate"; hreflang="de"

Opção 3:adicionar informações da versão de idioma ao sitemap.

<url>
<loc>https://example.com</loc>

<xhtml:link rel="alternate" hreflang="es"
href="https://es.example.com"/>

<xhtml:link rel="alternate" hreflang="de"
href="https://es.example.com"/>

</url>

Diretrizes para valores hreflang

  • O valor hreflang precisa sempre especificar um código de idioma.
  • O código de idioma precisa seguir o formato ISO 639-1.
  • O valor hreflang também pode incluir um código regional opcional. Por exemplo, es-mx é para falantes de espanhol no México, enquanto es-cl é para falantes de espanhol no Chile.
  • O código da região precisa seguir o formato ISO 3166-1 alpha-2.

Recursos