O documento não tem um hreflang válido

Muitos sites oferecem versões diferentes 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 mostrar a versão correta para cada idioma ou região.

Como a auditoria 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 se há códigos de idioma válidos nos links hreflang. O Lighthouse informa todos os links hreflang com códigos de idioma inválidos.

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

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

Suponha 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 informar 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:adicione 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 ter um link para todas as outras, inclusive para ela mesma. Caso contrário, os mecanismos de pesquisa podem ignorar os links hreflang ou interpretá-los incorretamente.

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

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

Opção 2:adicione cabeçalhos Link à 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:adicione informações sobre a versão do idioma ao seu 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 sempre precisa 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 alfa-2.

Recursos