Verifica hreflang: come validare i tag hreflang e correggere gli errori
L'hreflang dice ai motori di ricerca quale versione linguistica o regionale di una pagina mostrare a chi. L'idea è semplice. L'implementazione è fragile: ogni pagina deve elencare ogni versione, ogni versione deve ricambiare, e un solo codice sbagliato o un solo URL con redirect possono rendere inaffidabile un intero set. Un tool di verifica hreflang legge tutto in una volta.
Cosa fa un tool di verifica hreflang
I tag hreflang di una singola pagina dicono pochissimo. Gli errori che contano emergono solo confrontando le pagine tra loro: la pagina A elenca la pagina B, ma la pagina B elenca la pagina A? B risponde 200? B è canonica di sé stessa? Ecco perché un validatore hreflang per un singolo URL è utile per controlli a campione, mentre per un intero sito il tool di verifica hreflang è un crawler.
Una verifica completa legge i tag su ogni pagina, segue ogni destinazione e risponde a quattro domande per ogni set:
- Ogni codice è valido?
- Ogni pagina elenca sé stessa e tutte le altre versioni?
- Ogni destinazione ricambia il link?
- Ogni destinazione è un URL indicizzabile, canonico di sé stesso, che risponde 200?
Come funzionano i tag hreflang
La guida di Google alle versioni localizzate delle tue pagine descrive tre modi per dichiarare l'hreflang. Scegline uno per set.
| Metodo | Pagine HTML | PDF e file | Si trova in |
|---|---|---|---|
| Tag link | ✓ | – | Head HTML |
| Header HTTP Link | ✓ | ✓ | Risposta del server |
| Sitemap XML | ✓ | ✓ | File sitemap |
1. Tag link nell'head HTML
<link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="en-gb" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />
Le stesse quattro righe vanno su tutte e quattro le pagine, compresa quella x-default.
2. L'header HTTP Link
Utile per PDF e altri file che non hanno un head HTML:
Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
<https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"
3. La sitemap XML
<url>
<loc>https://example.com/en-us/pricing/</loc>
<xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
</url>
La sitemap richiede che il namespace xhtml sia dichiarato sul suo elemento urlset, e ogni voce url ripete l'intero set. Le sitemap tengono i set grandi fuori dall'head della pagina, ma è facile dimenticarle quando le pagine cambiano.
Le regole che ogni set hreflang deve seguire
- Autoreferenza. Google dice che ogni versione deve elencare sé stessa oltre a tutte le altre versioni.
- Link di ritorno. Se la pagina A punta alla pagina B, B deve puntare di nuovo ad A. Google dice che se due pagine non puntano entrambe l'una all'altra, i tag possono essere ignorati.
- URL assoluti. https://example.com/de/, non /de/.
- Destinazioni sane. Ogni destinazione deve rispondere 200, essere indicizzabile ed essere canonica di sé stessa. Un tag che punta a un redirect, a un 404 o a una pagina noindex è un segnale che i motori di ricerca devono aggirare.
- La pagina equivalente. La pagina prezzi tedesca deve puntare alla pagina prezzi francese, non alla home page francese.
I codici seguono standard fissi. Google li elenca nella sua guida alle versioni localizzate:
| Codice | Standard | Esempio | Valido |
|---|---|---|---|
| Lingua | ISO 639-1 | de, pt | ✓ |
| Lingua e regione | ISO 3166-1 Alpha 2 | de-at, pt-br | ✓ |
| Lingua e sistema di scrittura | ISO 15924 | zh-Hant | ✓ |
| Solo la regione | nessuno | us | – |
| Regno Unito | GB, non UK | en-uk | – |
| Fallback | Valore riservato | x-default | ✓ |
x-default: la versione di fallback
x-default è un valore riservato per la pagina da mostrare quando nessun'altra lingua o regione del set corrisponde al visitatore. Google lo suggerisce per le pagine di selezione della lingua e per le pagine che reindirizzano i visitatori in base alla lingua o alla posizione.
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
È facoltativo, ma è una buona idea sulla home page e su ogni pagina con un selettore di lingua. Come qualsiasi altra destinazione, l'URL x-default deve rispondere 200, essere indicizzabile ed essere canonico di sé stesso, e ogni pagina del set deve indicare lo stesso x-default. Un errore comune è puntare x-default a un URL che reindirizza i visitatori in base alla posizione, e poi lasciare che quel redirect finisca su un errore.
Gli errori hreflang più comuni
| Errore | Come si presenta | Correzione |
|---|---|---|
| Nessun link di ritorno | de non include en-us | Un elenco condiviso per set |
| Nessuna autoreferenza | La pagina non include sé stessa | Aggiungi il suo URL |
| Codice regione sbagliato | en-uk | en-gb |
| Regione senza lingua | hreflang="us" | en-us |
| URL relativo | /de/ | URL https completo |
| La destinazione fa redirect o dà errore | L'URL francese fa 301 | URL finale |
| La destinazione è canonicalizzata | URL con parametri | URL canonico |
| Un codice, due URL | Due pagine etichettate de | Un URL per codice |
| Tag fuori dall'head | Uno script chiude l'head in anticipo | Spostali in alto, o usa l'header |
| Lingua non corrispondente | hreflang fr, html lang en | Allinea al testo della pagina |
La guida all'implementazione di hreflang e SEO internazionale di SEO ProCheck approfondisce ciascuno di questi errori.
Hreflang e canonical
Hreflang e tag canonical lavorano insieme, e si rompono a vicenda facilmente. Ogni versione linguistica deve essere canonica di sé stessa. Se la pagina tedesca indica come canonical quella inglese, stai dicendo ai motori di ricerca che la pagina tedesca è un duplicato, il che va contro il suo hreflang. Un canonical punta all'interno di una lingua; l'hreflang punta tra le lingue.
Verifica anche che ogni URL di un set hreflang sia la versione canonica: stesso protocollo, stesso host, stesso slash finale. Un set che mescola URL http e https, o URL con e senza slash, non supera il controllo dei link di ritorno anche quando le pagine sono giuste, perché gli URL non coincidono esattamente.
Come verificare l'hreflang su tutto il sito
- Scansiona ogni versione linguistica. Se ogni lingua sta su un proprio dominio o sottodominio, includili tutti nel crawl, altrimenti i link di ritorno non si possono verificare.
- Leggi l'hreflang da ogni metodo che usi: l'head HTML, l'header HTTP Link e le sitemap. Un set dichiarato in due modi è un set che può contraddirsi.
- Valida i codici prima di tutto. Un solo codice sbagliato ripetuto da un template può colpire migliaia di pagine.
- Verifica link di ritorno e autoreferenze per ogni pagina.
- Verifica lo stato delle destinazioni: codice di stato, indicizzabilità e canonical di ciascuna.
- Cerca i set mancanti: pagine con equivalenti in altre lingue ma senza alcun hreflang.
- Correggi a livello di template o plugin, non pagina per pagina, poi scansiona di nuovo.
Lo facciamo sul nostro sito. neova.app è in 15 lingue. Nel nostro controllo SEO del 20 novembre 2026, le sue sitemap XML elencavano 1.358 URL, e ogni link hreflang era ricambiato: reciprocità completa. Con 15 versioni, ogni pagina elenca 15 URL, sé stessa compresa, e ognuno di questi deve ricambiarla. Genera ogni tag di un set da un unico elenco condiviso, e i link di ritorno vengono da sé.
I set hreflang sono il passo 12 della checklist per l'audit SEO tecnico. Se le tue versioni linguistiche reindirizzano i visitatori, leggi anche la guida alle catene di redirect.
Verificare l'hreflang con Neova
La categoria Internazionale di Neova mostra le versioni linguistiche e regionali di ogni pagina e se puntano l'una all'altra. Legge l'hreflang dall'head HTML e dall'header HTTP Link, aggiunge le colonne Lingue hreflang e Destinazioni hreflang a ogni pagina HTML, e confronta html lang con l'hreflang e con il testo della pagina stessa. Alcuni dei controlli:
- Link di ritorno hreflang mancante e Autoreferenza hreflang mancante
- Codice lingua hreflang non valido e Codice paese hreflang non valido
- Hreflang che punta a un URL non 200 e Hreflang che punta a un URL canonicalizzato
- Destinazione hreflang di fallback rotta, noindex, canonicalizzata o incoerente
- Hreflang che punta alla radice di una lingua invece che all'URL equivalente
- Hreflang e html lang in disaccordo sulla lingua
- Hreflang mancante dove esistono equivalenti in altre lingue
Ogni segnalazione dice perché conta, come risolverla e la sua fonte, e ogni tabella si esporta in CSV o Excel per lo sviluppatore che corregge il template. Neova esegue tutti i 694 controlli su ogni piano, Free compreso:
| Neova | |
|---|---|
| Funziona su | |
| Controlli | 694 |
| Piano gratuito | 1.000 URL per crawl |
| Lingue dell'interfaccia | 15 |
Mac significa Apple silicon; nel browser c'è Neova Online, con lo stesso account. Vedi le Funzionalità, i Prezzi o scarica Neova.
Domande
Che cos'è un tool di verifica hreflang?
Uno strumento che legge i tag hreflang di un sito e li confronta tra loro: codici di lingua e regione validi, autoreferenze, link di ritorno, x-default, e se ogni destinazione risponde 200, è indicizzabile ed è canonica di sé stessa.
Cosa sono i link di ritorno hreflang?
Se la pagina A elenca la pagina B come alternativa, anche la pagina B deve elencare la pagina A. Google dice che quando due pagine non puntano entrambe l'una all'altra, i loro tag hreflang possono essere ignorati.
x-default è obbligatorio?
No, è facoltativo. È consigliato per le pagine di selezione della lingua, le home page e le pagine che reindirizzano i visitatori in base alla lingua o alla posizione, così i motori di ricerca sanno quale versione mostrare quando nient'altro corrisponde.
Devo usare en-uk o en-gb?
en-gb. La parte della regione è un codice paese ISO 3166-1 Alpha 2, e il codice del Regno Unito è GB. en-uk non è un valore valido. Altre risposte come questa sono nelle FAQ su hreflang e SEO internazionale di SEO ProCheck.
Qual è il metodo hreflang migliore?
Per Google funzionano tutti e tre: tag link nell'head HTML, header HTTP Link o sitemap XML. Usa un solo metodo per set. I tag link sono i più facili da verificare, l'header è adatto ai PDF, e le sitemap tengono i set grandi fuori dalla pagina.