Dopo aver effettuato il push di un sito di staging in produzione, Yoast SEO può mantenere il dominio di staging come URL canonico, oppure eliminare del tutto il canonico. La soluzione è ricostruire gli indexable di Yoast in modo che rigeneri ogni canonico in base al dominio di produzione, e impostare manualmente il canonico per ogni singola pagina che risulta ancora sbagliata.
Perché gli URL canonici di Yoast sono sbagliati dopo una migrazione del sito?
Yoast SEO non calcola gli URL canonici a ogni caricamento di pagina. Li memorizza nei suoi indexable: una cache di dati SEO conservata nella tabella del database wp_yoast_indexable, più i valori per singolo articolo in wp_postmeta. Quando esegui il push di un sito di staging verso il tuo sito di produzione, quelle righe viaggiano insieme al database.
Se gli indexable sono stati creati mentre il sito usava ancora il dominio di staging, contengono URL di staging. Dopo il push noti uno di due sintomi:
- Il tag
rel="canonical"punta all’URL di staging (per esempiohttps://staging.example.com/page/invece dihttps://example.com/page/). - Il tag canonico è assente per alcune pagine, perché la riga dell’indexable memorizzata è obsoleta o incompleta.
La causa sono i dati degli indexable in cache, non un’installazione di Yoast difettosa. Yoast emette automaticamente un canonico autoreferenziale per ogni articolo e pagina pubblica: non esiste un interruttore globale di attivazione/disattivazione da azionare. Quindi l’obiettivo è far ricostruire a Yoast quella cache in base al dominio corretto.
Come correggo l’URL canonico di una singola pagina in Yoast SEO?
Se solo una o poche pagine sono interessate, sovrascrivi il canonico direttamente nell’editor:
- Apri la pagina o l’articolo interessato nell’editor di WordPress.
- Nella barra laterale di Yoast SEO (o nel box meta di Yoast sotto il contenuto), apri la scheda Avanzate.
- Individua il campo URL canonico.
- Inserisci l’URL di produzione corretto, oppure svuota il campo per lasciare che Yoast ripieghi sul suo canonico autoreferenziale predefinito in base al dominio di produzione.
- Aggiorna la pagina.
Lasciare il campo vuoto è solitamente la scelta giusta: un canonico autoreferenziale è ciò che la maggior parte delle pagine dovrebbe avere. Inserisci un URL esplicito solo quando la pagina deve puntare a un canonico diverso (per esempio una pagina sindacata o duplicata).
Come correggo in blocco gli URL canonici dopo una migrazione completa del sito?
Quando molte pagine riportano il dominio di staging, correggerle una a una è poco pratico. Ricostruisci invece tutti gli indexable in una volta sola.
Opzione 1: Reimpostare e riottimizzare i dati SEO di Yoast
- Installa e attiva il plugin Yoast Test Helper.
- Vai su Strumenti → Yoast Test.
- Fai clic su Reset Indexables & Migrations. Questo cancella gli indexable in cache, così Yoast li ricostruisce da zero.
- Vai su SEO → Strumenti e fai clic su Avvia ottimizzazione dei dati SEO. Yoast rigenera ogni indexable —inclusi gli URL canonici— in base al tuo dominio attuale (di produzione).
- Disattiva il plugin Yoast Test Helper una volta terminata l’ottimizzazione; è uno strumento per sviluppatori, non pensato per restare attivo.
Opzione 2: Ricostruire gli indexable con WP-CLI
Se hai accesso alla shell, la stessa ricostruzione si esegue dalla riga di comando:
wp yoast indexQuesto reindicizza tutti gli indexable di Yoast per il sito corrente. È più veloce dell’ottimizzatore basato su browser sui siti di grandi dimensioni ed è sicuro rieseguirlo.
Dopo l’una o l’altra opzione, svuota ogni cache —il tuo plugin di caching, la cache del server e la CDN— in modo che visitatori e crawler ricevano i tag canonici corretti invece di una copia in cache di quelli vecchi.
Un’ultima cosa da controllare: conferma che durante il push sia stato eseguito un cerca-e-sostituisci sul database, sostituendo il dominio di staging con il dominio di produzione. WP STAGING lo fa automaticamente quando esegui il push, ma se hai importato il database in un altro modo, un dominio di staging residuo nei dati è la causa principale che la sola ricostruzione degli indexable non risolverà.
Come prevengo i problemi di URL canonico al prossimo push?
- Lascia che WP STAGING gestisca la riscrittura del dominio. Quando esegui il push con WP STAGING, esegue un cerca-e-sostituisci su tutto il database, inclusi i dati di Yoast. Evita le importazioni manuali del database che saltano questo passaggio.
- Ricostruisci gli indexable dopo ogni push. Rendi "Reset Indexables & Migrations + ottimizzazione dei dati SEO" (o
wp yoast index) parte della tua checklist post-push. - Non impostare mai in modo fisso un canonico per pagina sul dominio di staging. Se hai impostato un canonico esplicito mentre testavi sullo staging, svuotalo prima del push in modo che la pagina di produzione ripieghi su un canonico autoreferenziale.
Per approfondire il motivo per cui i tag canonici contano, consulta la guida di Google sul consolidamento degli URL duplicati e la spiegazione di Yoast su rel="canonical".
Domande frequenti
Reimpostare gli indexable di Yoast eliminerà le mie impostazioni SEO?
No. Reimpostare gli indexable cancella solo i dati SEO in cache. Yoast li ricostruisce dai tuoi articoli e dalle tue impostazioni esistenti, quindi i tuoi titoli, meta description, parole chiave principali e configurazione restano intatti.
Perché il mio URL canonico è vuoto dopo una migrazione?
Un canonico assente significa quasi sempre che la riga dell’indexable della pagina è obsoleta o non è stata rigenerata in base al nuovo dominio. Ricostruire gli indexable (Opzione 1 o 2 sopra) ripristina il canonico autoreferenziale.
Mi serve il plugin Yoast Test Helper per risolvere questo problema?
È il modo più semplice per reimpostare indexable e migrazioni dall’amministrazione di WordPress. Se preferisci la riga di comando, wp yoast index esegue la ricostruzione senza alcun plugin aggiuntivo. In entrambi i casi, l’obiettivo è lo stesso: costringere Yoast a rigenerare i suoi dati SEO in cache.
Questo vale sia per Yoast SEO Free che per Premium?
Sì. Gli indexable esistono sia nella versione gratuita sia in quella Premium di Yoast SEO, quindi lo stesso processo di reset e ricostruzione corregge gli URL canonici in entrambe.
