Migrazione da WordPress a un CMS headless: una guida pratica

Passare al headless disaccoppia i contenuti di WordPress dal rendering, così puoi pubblicare un front end Next.js veloce mentre i redattori mantengono l'amministrazione che conoscono. Fatto bene, mantieni i posizionamenti e guadagni velocità. Fatto con superficialità, indicizzi un sito duplicato e perdi traffico il giorno del lancio. Ecco come farlo bene.

6 min di lettura8 sezioni22 giugno 2026

Scritto da

Kostadin Stamboliev

Fondatore e Imaginator

Fondatore e Imaginator di Pineido. Si occupa di consulenza IT, sviluppo di app e siti web, SEO tecnica, IA e automazione. Rilascia codice in produzione in sprint di 30 giorni con perimetro fisso e responsabilità chiare.

LinkedIn

Cosa significa davvero WordPress headless

Il WordPress tradizionale accoppia contenuto e presentazione: i temi PHP attingono dal database e renderizzano HTML a ogni richiesta. Il headless separa queste preoccupazioni. WordPress continua a gestire i contenuti (i tuoi redattori mantengono la stessa amministrazione), ma invece di renderizzare le pagine espone i contenuti tramite un'API. Un front end separato, quasi sempre Next.js nel 2026, recupera quel contenuto e renderizza il sito pubblico. Il vantaggio è reale: le pagine statiche o renderizzate all'edge si caricano abitualmente in meno di un secondo da una CDN, e i dati aggregati lo confermano. L'HTTP Archive Web Almanac ha rilevato che solo circa il 40% dei siti WordPress mobile supera tutti i Core Web Vitals, il valore più basso tra le principali piattaforme CMS, mentre i front end headless ben costruiti superano comunemente il 90%. Ma l'architettura abilita quel risultato, non lo garantisce. Un sito headless costruito male che sovraidrata i componenti e spedisce un bundle React di oltre 500KB perderà ogni volta contro un sito WordPress tradizionale ben messo in cache.

Decidi prima: ne hai davvero bisogno?

Il consiglio più onesto in tutto questo ambito è di non migrare se non hai un motivo. Se il tuo sito WordPress è lento, spesso puoi sistemarlo con 50 dollari al mese con un hosting migliore, WP Rocket o la cache Nginx FastCGI, una object cache Redis e l'ottimizzazione delle immagini. Una build headless costa tipicamente da 2 a 3 volte un progetto WordPress tradizionale comparabile, perché ora mantieni un'applicazione front end separata, un'infrastruttura di deploy e un impianto SEO su misura. Il headless si ripaga quando hai esigenze di prestazioni elevate con un budget all'altezza, quando pubblichi su più front end (web, app, chiosco) da un'unica fonte di contenuti, o quando vuoi un'esperienza di sviluppo moderna basata su componenti che il tuo team manterrà a lungo termine. Se il tuo sito attuale supera già 80 su PageSpeed, sistema prima quello che hai.

API REST o WPGraphQL

Questo è il bivio tecnico centrale. L'API REST è inclusa in WordPress (dalla 4.7), non richiede plugin e ti porta a circa l'80% del percorso con metà della complessità. WPGraphQL è un plugin gratuito con oltre 100.000 installazioni attive che consente al front end di richiedere esattamente i campi di cui ha bisogno in un'unica query, evitando l'over-fetching a cui REST è incline. Per un sito ricco di contenuti con dati annidati (articoli, autori, termini, campi personalizzati in una sola richiesta), WPGraphQL vale la dipendenza aggiuntiva e la curva di apprendimento. Se il tuo team non conosce GraphQL e la forma dei dati è semplice, REST è la scelta predefinita pragmatica. In ogni caso, se usi Advanced Custom Fields serve un cablaggio extra: i valori ACF risiedono in wp_postmeta e non compaiono in REST senza abilitare l'output REST per gruppo di campi, e gli stack GraphQL richiedono sia WPGraphQL sia il plugin WPGraphQL for ACF.

Esportare contenuti e media senza perdere dati

È qui che le migrazioni si rompono in silenzio. L'export XML standard di WordPress rovina i media perché le immagini sono memorizzate come articoli i cui ID vengono rigenerati all'import, così i campi immagine ACF che fanno riferimento a un vecchio ID finiscono per puntare al nulla. L'ordine di operazioni affidabile è prima i media: carica le risorse sulla tua CDN o sullo storage cloud (S3, Cloudinary o la pipeline di asset del tuo CMS) prima di importare i contenuti, poi riscrivi i riferimenti ai media verso i nuovi URL durante la trasformazione. Per i dati dei campi funzionano sia WP All Export Pro con l'add-on ACF, sia un export con script che cicla su acf_get_field_groups() ed esporta in JSON; esporta separatamente le definizioni dei gruppi di campi ACF tramite ACF > Tools. Metti in conto tempo extra per i contenuti dei builder: Elementor, Divi e WPBakery intrecciano contenuto e markup di layout in shortcode e dati serializzati, che resistono a un'estrazione automatizzata pulita. Tratta le pagine costruite visivamente come lavoro di migrazione manuale.

Preservare la SEO: la parte che determina il successo

La maggior parte della perdita di posizionamento nelle migrazioni headless deriva da due fallimenti. Primo, meta tag e JSON-LD iniettati da JavaScript dopo il caricamento. Google potrebbe non vederli. La soluzione non è negoziabile: renderizza titoli meta, descrizioni, canonical, Open Graph e dati strutturati nella risposta HTML effettiva usando SSG, SSR o ISR, mai solo lato client. Mantieni Yoast o Rank Math come unica fonte di verità per quei metadati e leggili tramite l'API. Secondo, l'origine WordPress ancora attiva che viene indicizzata come duplicato. Blindala: robots.txt blocca tutto tranne gli endpoint REST e GraphQL, invia X-Robots-Tag: noindex su ogni risposta HTML dall'origine, e rimuovi o restituisci 410 per la sitemap dell'origine. La strategia di URL più sicura è mantenere i percorsi identici (se /blog/my-post resta /blog/my-post, Google se ne accorge a malapena). Dove gli URL devono cambiare, mappa ognuno su un 301 in un CSV prima del lancio e fai il QA; un 301 configurato correttamente trasmette l'intero PageRank.

QA pre-lancio e la finestra di switchover

Esegui una scansione completa del tuo sito esistente con Screaming Frog, Sitebulb o Ahrefs prima di toccare qualsiasi cosa, catturando archivi, pagine di tag, serie paginate, pagine autore e tipi di post personalizzati, non solo gli URL ovvi. Poi punta lo stesso crawler verso lo staging e va' a caccia di 404, canonical mancanti, link interni rotti e codici di stato errati. Estrai un campione casuale di 50 vecchi URL e conferma che ognuno restituisca un 301 verso la destinazione corretta. Genera un'unica sitemap canonica dal front end affinché gli URL combacino esattamente con il sito pubblico, e reindirizza con un 301 la vecchia sitemap WordPress verso di essa. Lo switchover DNS è il momento a più alto rischio: punta a passare dallo switch alla validazione completa in meno di quattro ore, poi reinvia subito la sitemap nella Search Console. Per i siti grandi, procedi a fasi. Migra il blog, valida per 1-2 settimane, poi sposta la sezione successiva per limitare il raggio d'impatto.

Mantenere i contenuti freschi dopo il lancio

Le pagine statiche sono veloci ma diventano obsolete, quindi cabla la rivalidazione on-demand invece di aspettare ricostruzioni basate sul tempo. Lo schema: un webhook di WordPress (il plugin WP Webhooks o un hook save_post personalizzato) invia un POST a una route /api/revalidate di Next.js con un token segreto e il percorso o il tag interessato, così solo le pagine modificate vengono rigenerate. L'invalidazione basata su tag è più pulita quando una sola modifica tocca molte pagine. Un'avvertenza di hosting che morde i team: l'ISR on-demand richiede un host che supporti l'API di rivalidazione di Next.js. Vercel lo fa in modo nativo; alcuni host WordPress gestiti e alcune configurazioni multi-container Docker o Kubernetes no, perché una chiamata di rivalidazione raggiunge sempre un solo container. Aggiungi una object cache Redis e una cache delle risposte GraphQL lato WordPress affinché le risposte dell'API non vengano ricalcolate a ogni rigenerazione.

Budget e dove si inserisce Pineido

L'hosting per il front end è modesto all'inizio ma a consumo. Vercel Pro costa 20 dollari per postazione al mese con 20 dollari di credito d'uso, e i costi che sorprendono le persone sono la banda (fatturata a 0,15 dollari/GB oltre la franchigia di 1TB di Pro), le richieste edge e le letture e scritture ISR. Imposta gli avvisi di spesa al 75% e al 100%. La voce più consistente è l'ingegneria della migrazione stessa, che è esattamente il tipo di lavoro circoscritto e ad alto rischio adatto a uno sprint a perimetro fisso. Pineido esegue le migrazioni da WordPress al headless come uno sprint a prezzo fisso di 30 giorni a 8.500 dollari: export di contenuti e media con riscrittura dei riferimenti, un front end Next.js su WPGraphQL o REST, SEO renderizzata lato server, una mappa completa di redirect 301, blindatura dell'origine e rivalidazione on-demand, con un diff di scansione pre-lancio così puoi vedere che nulla è regredito prima di cambiare il DNS.

Pronto a rilasciare?

Dicci dove sei bloccato. Lo esaminiamo e ti inviamo una raccomandazione mirata entro un giorno lavorativo.

Domande frequenti

Perderò i posizionamenti SEO passando al headless?

No, se la migrazione è fatta correttamente. La perdita di posizionamento deriva da due errori evitabili: iniettare meta tag e dati strutturati con JavaScript lato client invece di renderizzarli nell'HTML, e lasciare la vecchia origine WordPress scansionabile così da farla indicizzare come duplicato. Renderizza tutti i metadati SEO lato server, mantieni gli URL identici dove possibile (o mappa ogni cambiamento su un 301), e applica noindex più il blocco robots all'origine. Le migrazioni che preservano canonical, redirect, sitemap e dati strutturati di solito si posizionano altrettanto bene o meglio dopo.

Dovrei usare l'API REST di WordPress o WPGraphQL?

REST è incluso in WordPress, non richiede plugin ed è la scelta predefinita più semplice per siti con dati lineari. WPGraphQL (un plugin gratuito con oltre 100.000 installazioni) consente al front end di recuperare esattamente i campi di cui ha bisogno in un'unica query, il che è migliore per siti ricchi di contenuti con dati annidati come articoli, autori, termini e campi personalizzati. Scegli REST per la semplicità, WPGraphQL per la precisione delle query e le prestazioni su modelli di contenuto complessi.

I miei Advanced Custom Fields sopravvivono alla migrazione?

Sì, ma richiedono una gestione extra. I valori ACF risiedono in wp_postmeta e non compaiono nell'API REST a meno che tu non abiliti l'output REST per gruppo di campi, e le configurazioni GraphQL richiedono sia WPGraphQL sia WPGraphQL for ACF. Esporta separatamente le definizioni dei gruppi di campi tramite ACF > Tools, ed esporta i dati effettivi dei campi con WP All Export Pro più l'add-on ACF o uno script. Fai particolare attenzione ai campi immagine, poiché l'export standard di WordPress rompe i riferimenti agli ID dei media.

Il mio team può ancora modificare i contenuti in WordPress dopo la migrazione?

Sì, è il principale richiamo del headless. WordPress resta il backend dei contenuti e i redattori mantengono la stessa interfaccia di amministrazione, gli articoli, le pagine e la libreria media. L'unico cambiamento è che i contenuti vengono pubblicati su un front end Next.js separato tramite l'API. Con la rivalidazione on-demand cablata tramite un webhook, le modifiche compaiono sul sito live entro pochi secondi dal salvataggio, senza una ricostruzione completa o un deploy da parte di uno sviluppatore.

Quanto costa una migrazione WordPress al headless?

Una build headless costa tipicamente da 2 a 3 volte un progetto WordPress tradizionale comparabile, perché mantieni un'applicazione front end separata, un'infrastruttura di deploy e un impianto SEO su misura. L'hosting del front end parte in modo modesto (Vercel Pro costa 20 dollari per postazione al mese, con banda e uso ISR fatturati a consumo in aggiunta). Pineido esegue la migrazione stessa come uno sprint a prezzo fisso di 30 giorni a 8.500 dollari, coprendo l'export, il front end Next.js, la SEO renderizzata lato server, i redirect e la rivalidazione.

Quanto tempo richiede una migrazione WordPress al headless?

Un sito di contenuti tipico richiede 2-4 settimane: export di contenuti e media con riscrittura dei riferimenti, costruzione del front end Next.js, cablaggio della SEO lato server e della rivalidazione, e una scansione approfondita pre-lancio. I siti grandi o molto basati su builder richiedono più tempo, perché i contenuti di Elementor, Divi e WPBakery resistono a un'estrazione automatizzata pulita e spesso necessitano di migrazione manuale. I siti con oltre 5.000 articoli, contenuti multilingue o campi personalizzati complessi sono una classe di progetto diversa e beneficiano di un rilascio a fasi, sezione per sezione.

Spunti operativi ogni settimana

Unisciti ai responsabili di aziende di servizi che ricevono ogni settimana uno spunto concreto su operazioni, automazione e crescita.

Stiamo verificando che sia una persona. Potrà inviare tra un momento.

Niente spam. Disiscriviti quando vuoi.

Iscrizione completata! Cerca il prossimo numero nella tua casella di posta.