hreflang: gli errori comuni e come trovarli

Un hreflang sbagliato non produce un errore visibile: Google scarta l'annotazione e serve la versione che ritiene adatta, spesso quella sbagliata. Gli errori ricorrenti sono cinque, e tre di questi si trovano con uno script prima del deploy.

Come si dichiara

Si dichiara con un elemento link nell'head, oppure con xhtml:link dentro la sitemap. Ogni pagina elenca sé stessa e tutte le altre versioni, con URL assoluti: un href relativo viene ignorato. Il codice lingua segue ISO 639-1, la regione ISO 3166-1 alpha-2, e x-default indica la pagina di fallback quando nessuna lingua è la scelta giusta.

Errore 1: manca il ritorno

Una sola direzione non basta. Se la pagina italiana elenca quella inglese e la pagina inglese non elenca quella italiana, Google tratta l'annotazione come non confermata e può ignorarla. La variante più frequente è l'auto-riferimento mancante: ogni pagina deve elencare anche sé stessa.

Errore 2: codici lingua inventati

en-UK non esiste: la regione del Regno Unito è GB. it-IT è valido ma inutile, perché it senza regione copre già l'italiano. Un codice come en-EU non corrisponde a nessuno stato e viene scartato. Il confronto è case-insensitive, ma la forma leggibile resta minuscola per la lingua e maiuscola per la regione.

Errore 3: canonical che contraddice hreflang

Ogni versione linguistica dichiara sé stessa come canonical. Se la pagina inglese ha canonical verso l'italiana, Google considera l'inglese un duplicato e all'hreflang restano due URL che puntano allo stesso posto. Canonical e hreflang rispondono a due domande diverse: quale URL è quello giusto, e quale lingua serve a chi.

Errore 4: la destinazione reindirizza o è noindex

Un hreflang che punta a un URL che reindirizza, che risponde 404 o che porta noindex viene ignorato. Succede quando cambia lo slug della traduzione e l'annotazione resta indietro. La verifica è meccanica: si segue ogni href e si controlla lo status della risposta.

Errore 5: hreflang su contenuti non tradotti

hreflang collega versioni della stessa pagina in lingue diverse, non pagine che parlano dello stesso argomento. Due articoli diversi, uno italiano e uno inglese, non sono alternates: sono due pagine, e vanno collegate con un link normale.

Controllarlo sulla sitemap

cat > check-hreflang.mjs ([\s\S]*?)/g)].map((m) => m[1]);
const locs = new Set(blocks.map((b) => (b.match(/([^/) || [])[1]));
let broken = 0;
for (const block of blocks) {
  const loc = (block.match(/([^/) || [])[1];
  const alts = [...block.matchAll(/hreflang="([^"]+)" href="([^"]+)"/g)]
    .map((m) => ({ lang: m[1].toLowerCase(), href: m[2] }));
  for (const alt of alts) {
    if (locs.has(alt.href)) continue;
    broken++;
    console.log("NOT DECLARED " + alt.href + " (from " + loc + ")");
  }
  console.log(alts.map((a) => a.lang).join(",") + "  " + loc);
}
console.log(blocks.length + " URLs · " + broken + " alternates without a target");
EOF
node check-hreflang.mjs

Lo script legge la sitemap del blog, raccoglie per ogni URL le annotazioni hreflang e verifica che ogni destinazione sia dichiarata nel file. Un URL citato e mai dichiarato è una coppia rotta: Google legge l'annotazione ma non trova la pagina che dovrebbe confermarla.

Il catalogo EneUI

Un selettore di lingua non è un componente SEO, ma è il punto in cui gli errori nascono: language-switcher-pill, licenza MIT, cambia URL senza ricaricare la pagina; language-selector-dropdown non dichiara una licenza nel record e va verificato prima dell'uso. I blocchi navbar mostrano dove quel selettore finisce. Dati verificati il 1 novembre 2026.

La limitazione

hreflang è un segnale, non una direttiva: Google può ignorarlo se il contenuto non è davvero equivalente. Nessun validatore vede quella differenza, perché richiede di leggere entrambe le versioni. Search Console segnala le coppie senza ritorno, non le traduzioni fatte male.

Dove continuare

Come si divide un indice di URL è in sitemap index o sitemap unico; la sequenza per entrare nell'indice è in indicizzare un sito su Google. Se la scelta è tra due stack per un sito marketing, il confronto è in Next.js o Vite per un sito marketing.