L'hreflang è un'annotazione che dice a Google quali pagine del tuo sito sono versioni dello stesso contenuto in lingue o paesi diversi, così che a un utente tedesco esca la pagina tedesca e a uno svizzero quella svizzera. Funziona solo se ogni versione elenca tutte le altre e anche se stessa, con codici di lingua e paese scritti secondo gli standard ISO, e se gli URL indicati rispondono senza redirect e sono indicizzabili.
Non è un fattore di posizionamento. Non fa salire una pagina debole. Evita che Google mostri la versione sbagliata a chi cerca dal paese giusto. In questa guida vediamo come si scrive, dove si mette, come si controlla e quali sono gli errori che troviamo più spesso nei siti multilingua delle aziende italiane che vendono all'estero.
In questo articolo
Un sito che vende in più paesi ha spesso pagine molto simili tra loro. La scheda di una macchina per il Regno Unito e quella per gli Stati Uniti possono differire solo per unità di misura e contatti. Senza indicazioni Google sceglie da solo quale versione mostrare, e capita che un buyer di Vienna veda la pagina tedesca con i riferimenti al distributore di Monaco.
L'hreflang serve a collegare queste versioni in un gruppo e a dire a Google per quale lingua, ed eventualmente per quale paese, è pensata ciascuna. Google usa questo gruppo per sostituire nei risultati l'URL più adatto all'utente. La pagina che si posiziona è sempre una, ma l'indirizzo che compare cambia in base a chi cerca.
È uno strumento tecnico, utile quando le versioni esistono già e sono scritte bene, perché nel marketing multilingue tradurre le pagine non basta. Se il problema è che il sito tedesco non intercetta le ricerche giuste, la soluzione sta nei contenuti e nella ricerca delle parole chiave localizzata, che l'hreflang non sostituisce.
La prima cosa da sapere è che l'hreflang è un segnale, e Google non è obbligato a seguirlo. Google lo prende in considerazione insieme ad altri elementi, come la lingua effettiva del testo, i link che puntano alla pagina e la canonical. Se le indicazioni sono contraddittorie, Google le ignora in tutto o in parte e decide da solo.
La seconda è che non serve a far capire a Google in che lingua è scritta una pagina. La documentazione ufficiale lo dice in modo esplicito: la lingua viene riconosciuta da algoritmi che leggono il contenuto, e né l'hreflang né l'attributo lang dell'HTML vengono usati per questo. Una pagina con testo italiano e hreflang "de" resta una pagina italiana.
Il valore dell'hreflang ha due parti. La prima è obbligatoria ed è il codice della lingua secondo lo standard ISO 639-1, cioè due lettere minuscole come it, de, fr, en, es. La seconda è facoltativa ed è il codice del paese secondo lo standard ISO 3166-1 alpha-2, due lettere che per convenzione si scrivono maiuscole, separate dalla lingua con un trattino.
Alcuni esempi corretti che usiamo spesso nei progetti per aziende italiane:
Il paese da solo non è ammesso. Un valore come "CH" o "BE" non dice quale lingua si parla nella pagina, e in paesi con più lingue ufficiali non avrebbe senso. Google lo ignora. Va anche ricordato che la documentazione di Google accetta solo codici paese della lista ISO 3166-1 alpha-2, quindi valori regionali come es-419 per l'America Latina, diffusi in altri contesti, non sono supportati da Google come area geografica.
Il paese va scelto in base al mercato e non alla sola lingua. Chi lavora sulla SEO in Francia e vuole raggiungere anche i clienti belgi o svizzeri, per esempio, deve decidere se una sola versione "fr" basta o se servono pagine separate con contatti, prezzi e riferimenti normativi diversi.
La regola pratica è indicare il paese solo quando esiste una differenza reale tra le versioni. Se il sito ha una sola versione in tedesco, valida per Germania, Austria e Svizzera, basta "de". Aggiungere "de-DE" su quella pagina la restringerebbe senza motivo, e gli utenti austriaci finirebbero per vedere un risultato meno pertinente.
Il paese serve quando le pagine cambiano per contenuto commerciale: prezzi in valute diverse, condizioni di spedizione, riferimenti a filiali o distributori locali, normative. In questi casi conviene avere una versione per ogni paese e, se possibile, anche una versione solo lingua che faccia da riferimento per i paesi non coperti. Un sito con en-GB ed en-US, per esempio, può aggiungere "en" per un utente anglofono che cerca dall'Irlanda o dall'India.
Il metodo più diffuso è inserire nel blocco head di ogni pagina un elemento link per ciascuna versione, compresa quella corrente. Il blocco per una scheda prodotto disponibile in italiano, tedesco per la Germania e tedesco per l'Austria contiene quindi tre elementi link, uno per ogni versione.
<link rel="alternate" hreflang="it" href="https://www.esempio.com/it/pompa-x/" />
<link rel="alternate" hreflang="de-DE" href="https://www.esempio.com/de-de/pumpe-x/" />
<link rel="alternate" hreflang="de-AT" href="https://www.esempio.com/de-at/pumpe-x/" />
<link rel="alternate" hreflang="x-default" href="https://www.esempio.com/" />
Lo stesso identico blocco va ripetuto su tutte e tre le pagine. Gli URL devono essere assoluti e scritti esattamente come la versione indicizzabile della pagina, con o senza slash finale a seconda di come risponde il sito. È il metodo più facile da controllare a vista, ma su siti con molte lingue appesantisce l'HTML.
Il secondo metodo sposta le annotazioni nella sitemap. Ogni URL viene dichiarato con tutte le sue versioni alternative tramite l'elemento xhtml:link, e la sitemap deve dichiarare il namespace xhtml in apertura.
<url>
<loc>https://www.esempio.com/it/pompa-x/</loc>
<xhtml:link rel="alternate" hreflang="it" href="https://www.esempio.com/it/pompa-x/" />
<xhtml:link rel="alternate" hreflang="de-DE" href="https://www.esempio.com/de-de/pumpe-x/" />
</url>
Conviene sui siti con molte pagine e molte lingue e quando il CMS rende complicato modificare l'head. Lo svantaggio è che le annotazioni non si vedono aprendo la pagina, quindi gli errori si scoprono solo con strumenti di analisi, e la sitemap cresce in fretta perché ogni URL ripete l'elenco completo delle alternative.
Google considera equivalenti i metodi di inserimento (HTML, sitemap e intestazione HTTP) e non dà alcun vantaggio a chi li usa insieme. Anzi, usarne due aumenta il rischio di indicazioni discordanti quando una delle due fonti non viene aggiornata. Meglio sceglierne uno e mantenerlo.
Un PDF non ha un head in cui inserire i link. Per schede tecniche, cataloghi e manuali scaricabili in più lingue si usa l'intestazione HTTP Link, che il server invia insieme al file e che contiene gli stessi valori rel="alternate" e hreflang usati nell'HTML, con l'URL di ogni versione del documento.
Per le aziende manifatturiere il caso è frequente. Le schede tecniche ricevono ricerche molto specifiche, e capita che un ingegnere tedesco trovi il PDF italiano perché è l'unico che Google ha collegato alla sua ricerca. La configurazione si fa sul server e va testata da chi ne ha accesso.
Il requisito che fa saltare più configurazioni è la reciprocità. Se la pagina italiana indica la tedesca come alternativa, la tedesca deve indicare a sua volta l'italiana. Google lo richiede perché chiunque potrebbe dichiarare una pagina altrui come propria traduzione: il link di ritorno conferma che entrambe le pagine appartengono allo stesso gruppo. Se il ritorno manca, l'annotazione tra quelle due pagine viene ignorata.
Il secondo requisito è l'auto-riferimento. Ogni pagina deve includere nel proprio elenco anche se stessa, con il codice della sua lingua. L'elenco quindi è identico su tutte le versioni del gruppo, e questo rende facile anche il controllo: se su una pagina il blocco hreflang ha una riga in meno o un URL diverso dalle altre, c'è un errore.
Il valore x-default indica la pagina da mostrare quando la lingua o il paese dell'utente non corrispondono a nessuna delle versioni dichiarate. Non ha un codice lingua ed è opzionale, ma su un sito internazionale conviene usarlo sempre.
Le scelte più comuni sono due. La prima è una pagina di selezione della lingua, dove l'utente sceglie il paese da un elenco. La seconda è la versione in inglese, che per molte aziende italiane è la lingua usata con i mercati non coperti, così un utente svedese non atterra sulla pagina in italiano. Ogni gruppo ha un solo x-default, che può coincidere con una delle versioni già dichiarate.
Qui nascono molti problemi. La canonical dice a Google qual è l'URL principale di una pagina tra più URL con lo stesso contenuto. L'hreflang dice quali URL sono versioni alternative per lingue diverse. Se le due indicazioni si contraddicono, prevale di solito la canonical e l'hreflang perde efficacia.
La regola è che ogni versione linguistica abbia una canonical verso se stessa, oppure verso un'altra pagina nella stessa lingua. La pagina tedesca non deve mai avere la canonical verso quella italiana o inglese. Se lo fa, sta dicendo a Google che è un duplicato da non indicizzare, e nello stesso momento l'hreflang le chiede di mostrarla agli utenti tedeschi.
Google nella sua guida sui duplicati chiede di indicare una canonical nella stessa lingua, o nella lingua sostitutiva più vicina se non esiste una pagina canonica nella stessa lingua, e segnala di preferire come canonici gli URL che fanno parte di un gruppo hreflang. Nella pratica, canonical autoreferenziale su ogni versione e hreflang che collega le versioni tra loro.
Gli errori che incontriamo negli audit si ripetono quasi sempre uguali. I più comuni sono questi:
Molti siti internazionali portano automaticamente l'utente sulla versione della sua lingua, leggendo l'indirizzo IP o le impostazioni del browser. Per l'utente sembra comodo, ma per la SEO crea problemi seri. Google sconsiglia esplicitamente di reindirizzare in automatico da una versione linguistica a un'altra, perché in questo modo né gli utenti né il motore riescono a raggiungere tutte le versioni.
Il motivo tecnico è che Googlebot effettua la scansione di solito da indirizzi IP degli Stati Uniti e senza indicare una lingua preferita nella richiesta. Un sito che reindirizza per IP mostrerà a Googlebot sempre e solo la versione americana o inglese, e le altre rischiano di non essere scansionate.
L'alternativa corretta è lasciare che ogni URL mostri sempre la propria versione e proporre all'utente, se serve, un avviso con il link alla versione del suo paese, insieme a un selettore di lingua visibile in ogni pagina.
Fino al 2022 Search Console aveva un report dedicato al targeting internazionale, che segnalava gli errori hreflang. Google lo ha dismesso nel settembre 2022, precisando che continua a usare l'hreflang presente nelle pagine. Oggi in Search Console non esiste un report che elenchi gli errori hreflang.
Restano comunque strumenti utili. Il controllo URL di Search Console mostra quale pagina Google ha scelto come canonica, e se la versione tedesca risulta canonicalizzata su quella italiana il problema emerge subito. Il report sul rendimento, filtrato per paese, mostra se gli utenti di un paese arrivano sulla versione giusta: se dalla Svizzera arrivano clic soprattutto sulle pagine tedesche, l'hreflang de-CH non sta funzionando.
Per un controllo completo servono i crawler SEO, come Screaming Frog, Sitebulb o i moduli di audit di Semrush e Ahrefs, che segnalano link di ritorno mancanti, codici non validi, URL in redirect o in noindex e incoerenze con la canonical. La scansione va ripetuta dopo ogni pubblicazione importante e dopo ogni migrazione del sito.
La maggior parte dei CMS moderni genera l'hreflang in automatico, a condizione che le traduzioni siano collegate tra loro. Su WordPress se ne occupano plugin come WPML o Polylang, su Shopify i mercati e le lingue configurate nel pannello, su altri sistemi moduli dedicati. Il punto debole è sempre lo stesso: il collegamento tra le pagine equivalenti va fatto bene, una per una.
I problemi tipici dei CMS sono pagine tradotte non collegate all'originale, che quindi escono dal gruppo, codici impostati male in fase di configurazione (en invece di en-GB, o viceversa), e versioni linguistiche lasciate in bozza o in noindex ma ancora elencate nell'hreflang. Sui siti di e-commerce si aggiungono le pagine filtrate e le varianti prodotto, che generano molti URL e moltiplicano gli errori. Ne parliamo nella guida alla SEO per e-commerce multilingue.
L'hreflang funziona allo stesso modo con tutte le strutture: domini nazionali come esempio.de, sottocartelle come esempio.com/de/ e sottodomini come de.esempio.com. Funziona anche tra domini diversi, purché il collegamento sia reciproco. La struttura cambia invece la manutenzione, i costi e il modo in cui si distribuisce l'autorità del sito.
La scelta tra le tre soluzioni dipende da quanti mercati si vogliono presidiare, da quante risorse ci sono per seguirli e da quanto conta la percezione locale. L'abbiamo trattata nel dettaglio nell'articolo su come strutturare le URL di un sito internazionale. Qui basta ricordare che, con domini separati, l'hreflang va mantenuto su più siti e spesso su più CMS, e il rischio che un gruppo si rompa aumenta.
Un caso a parte è il sito con un solo dominio in inglese pensato per tutto il mondo. In quel caso l'hreflang non serve, perché non ci sono versioni alternative da collegare. Diventa necessario dal giorno in cui si aggiunge una seconda lingua, e i limiti di questa scelta li trovi nell'analisi su vantaggi e svantaggi della SEO in inglese.
È la situazione in cui l'hreflang dà il contributo più evidente. Pensiamo a un'azienda che ha una versione inglese per il Regno Unito e una per gli Stati Uniti, o una tedesca per Germania e Austria, con testi quasi uguali. Senza hreflang, Google tende a considerarle duplicati, ne sceglie una come canonica e mostra quella in entrambi i paesi.
Con l'hreflang Google può comunque raggrupparle e trattarle come una sola pagina per l'indicizzazione, ma nei risultati mostra l'URL adatto al paese di chi cerca. Per questo la versione americana può comparire negli Stati Uniti anche se Google ha scelto quella britannica come canonica. Conviene comunque differenziare le versioni dove c'è una ragione concreta: ortografia e terminologia diverse, unità di misura, valute, riferimenti a sedi e contatti locali, norme e certificazioni del paese. Le differenze tra i due mercati anglofoni sono descritte nel confronto tra Regno Unito e Stati Uniti.
Su un sito esistente il lavoro segue quasi sempre lo stesso ordine. Si parte da una scansione completa per avere l'elenco degli errori, poi si controlla in Search Console se ci sono versioni linguistiche canonicalizzate su altre lingue o pagine importanti fuori indice. Questi due controlli dicono subito se il problema è grave o marginale.
Poi si correggono gli errori in ordine di impatto: prima canonical e noindex sbagliati, che tolgono pagine dall'indice, poi codici non validi e link di ritorno mancanti, infine x-default e casi particolari. Google impiega qualche settimana a rielaborare le pagine.
Chi gestisce un sito in molte lingue e vuole un controllo esterno può affidarsi a un'agenzia SEO internazionale che segua anche la parte tecnica. In Mintense lavoriamo dal 2008 su siti in 16 lingue, e l'hreflang è uno dei primi punti che verifichiamo in ogni audit, insieme alla struttura delle URL e alla link building nei singoli paesi. Prima di qualsiasi intervento è utile leggere la documentazione di Google sulle versioni localizzate, che è il riferimento più aggiornato.
Il tag hreflang è un'annotazione che collega tra loro le versioni di una pagina in lingue o paesi diversi e indica a Google per chi è pensata ciascuna. Si scrive con un codice lingua ISO 639-1, come it o de, seguito facoltativamente da un codice paese ISO 3166-1 alpha-2, come de-AT o en-GB. Si può inserire nel codice HTML della pagina, nella sitemap XML o nell'intestazione HTTP. Google lo usa per mostrare nei risultati l'URL più adatto all'utente, senza farne un fattore di posizionamento.
Non in modo diretto. L'hreflang non aumenta l'autorità di una pagina e non la fa salire nei risultati. Serve a far comparire la versione giusta, per lingua e paese, tra quelle che Google ha già deciso di posizionare. L'effetto indiretto può essere positivo, perché un utente che trova la pagina nella propria lingua clicca più volentieri e resta sul sito, ma il posizionamento dipende dalla qualità dei contenuti, dalla ricerca delle parole chiave fatta nel paese e dai link che il sito riceve da quel mercato.
Il valore x-default indica la pagina da mostrare agli utenti la cui lingua o il cui paese non corrispondono a nessuna delle versioni dichiarate nel gruppo hreflang. Di solito punta a una pagina di selezione della lingua oppure alla versione in inglese, che per molte aziende è la lingua usata con i mercati non coperti. È opzionale ma consigliato su ogni sito internazionale, e ogni gruppo di pagine ne ha uno solo. Può coincidere con una delle versioni già elencate, ripetendo lo stesso URL con valore diverso.
Il codice corretto è en-GB, perché GB è la sigla del Regno Unito nello standard ISO 3166-1 alpha-2. L'errore più comune è scrivere en-UK, che sembra logico ma non è valido: Google ignora la parte di paese e l'annotazione perde la sua funzione. Lo stesso vale per altri codici intuitivi ma sbagliati, come jp per il giapponese, che si scrive ja. Prima di pubblicare conviene confrontare ogni codice con gli elenchi ufficiali delle due norme ISO o affidarsi a un crawler che segnali i valori non validi.
Dal 2022 Search Console non ha più un report dedicato all'hreflang, quindi il controllo si fa con altri strumenti. Il controllo URL di Search Console mostra quale pagina Google considera canonica e fa emergere le versioni linguistiche canonicalizzate su altre lingue. Il report sul rendimento filtrato per paese mostra se gli utenti arrivano sulla versione giusta. Per l'elenco completo degli errori servono crawler SEO come Screaming Frog o Sitebulb, che segnalano link di ritorno mancanti, codici non validi e URL in redirect o noindex.
Sì, e anzi vanno usati insieme. Ogni versione linguistica deve avere una canonical verso se stessa, o al massimo verso un'altra pagina nella stessa lingua, e un blocco hreflang che elenca tutte le versioni del gruppo. L'errore da evitare è la canonical che punta a una pagina in un'altra lingua, per esempio dalla versione tedesca a quella italiana. In quel caso la pagina tedesca viene trattata come duplicato e l'hreflang perde efficacia, perché le due indicazioni si contraddicono e Google tende a seguire la canonical.