Il documento non contiene un valore hreflang valido

Molti siti forniscono versioni diverse di una pagina in base alla lingua o all'area geografica dell'utente. I link hreflang indicano ai motori di ricerca gli URL di tutte le versioni di una pagina in modo da poter mostrare la versione corretta per ogni lingua o regione.

Come il controllo di Lighthouse hreflang non va a buon fine

Lighthouse segnala link hreflang errati:

Controllo Lighthouse che mostra link hreflang errati

Lighthouse controlla la presenza di link hreflang in head della pagina e nelle relative intestazioni della risposta.

Lighthouse quindi verifica la presenza di codici lingua validi all'interno dei hreflanglink. Lighthouse segnala tutti i link hreflang con codici di lingua non validi.

Lighthouse non controlla i codici regione o la tua Sitemap.

Come definire un link hreflang per ogni versione di una pagina

Supponi di avere tre versioni di una pagina:

  • Una versione in inglese all'indirizzo https://example.com
  • Una versione spagnola all'indirizzo https://es.example.com
  • Una versione tedesca in https://de.example.com

Esistono tre modi per comunicare ai motori di ricerca che queste pagine sono equivalenti. Scegli il metodo più adatto alla tua situazione.

Opzione 1: aggiungi i link hreflang alla sezione <head> di ogni pagina:

<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" />

Ogni versione di una pagina deve rimandare a tutte le altre versioni, inclusa la pagina stessa. In caso contrario, i motori di ricerca potrebbero ignorare i link hreflang o interpretarli in modo errato.

Per le pagine che consentono agli utenti di selezionare la lingua, utilizza la parola chiave x-default:

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

Opzione 2. Aggiungi intestazioni Link alla risposta 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"

Opzione 3: aggiungi informazioni sulla versione in lingua alla 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>

Linee guida per i valori hreflang

  • Il valore hreflang deve sempre specificare un codice lingua.
  • Il codice lingua deve rispettare il formato ISO 639-1.
  • Il valore hreflang può includere anche un codice regionale facoltativo. Ad esempio, es-mx è per gli utenti di lingua spagnola in Messico, mentre es-cl è per gli utenti di lingua spagnola in Cile.
  • Il codice regione deve rispettare il formato ISO 3166-1 alpha-2.

Risorse