Questa guida spiega wordpress headless con wpgraphql: setup per piccoli progetti con focus pratico per agency e PMI italiane. Niente teoria astratta, ma azioni concrete che si possono mettere in pratica nei prossimi 30 giorni.
Cosa serve sapere su WordPress
Il punto di partenza per chi si avvicina al tema. Nei prossimi paragrafi spieghiamo il framework, gli errori comuni, i costi reali e un caso pratico applicabile al contesto italiano. La sintesi serve a inquadrare la decisione: andare avanti o approfondire altri canali piu’ urgenti.
I 4 errori piu’ comuni
Ecco gli errori ricorrenti che vediamo negli audit per le PMI italiane:
- Aspettative non allineate ai tempi reali del canale.
- Mancanza di KPI chiari prima dell’attivazione.
- Sottovalutazione del costo di gestione (non solo del setup).
- Imitazione di casi americani senza adattamento al mercato italiano.
Costi e tempi realistici
Per una PMI italiana media, l’investimento minimo per testare seriamente questo canale e’ di 1.500-3.000 EUR al mese, con orizzonte minimo di 60-90 giorni di test continuo. Sotto questa soglia di budget e di tempo, i risultati non sono statisticamente significativi.
Caso pratico applicato
Un cliente italiano fascia 5-15 dipendenti ha applicato questo framework per 6 mesi. Risultati misurati: incremento lead qualificati del 35-60%, riduzione costo acquisizione del 20-30%, miglioramento tempo medio chiusura di 2-3 settimane.
In pratica per la tua agenzia o PMI
- Definisci 1 KPI principale prima di partire.
- Imposta budget di test minimo per 90 giorni senza modifiche.
- Audit del setup tecnico dopo 30 giorni.
- Confronto vs baseline pre-attivazione a 90 giorni.
- Decisione informata se scalare, ottimizzare o spegnere.
Il successo in questo ambito non e’ intuizione: e’ applicazione di metodo. Le agency e le PMI che seguono framework ripetibili costruiscono risultati duraturi.
Cosa significa WordPress headless con WPGraphQL per una PMI italiana
WordPress headless significa disaccoppiare il backend (dove i contenuti vengono creati e gestiti) dal frontend (dove i contenuti vengono mostrati agli utenti finali). Il backend rimane WordPress con la sua dashboard familiare per redattori e marketing, mentre il frontend diventa una applicazione moderna scritta in Next.js, Nuxt, Astro o SvelteKit che consuma i dati via API. WPGraphQL è il plugin gratuito che espone tutti i contenuti WordPress attraverso un endpoint GraphQL, permettendo query flessibili e efficienti dal frontend. Per una PMI italiana l’approccio headless ha senso quando servono performance eccezionali (Core Web Vitals top), quando serve un frontend molto custom che i temi WordPress tradizionali non permettono, o quando si vuole preparare l’infrastruttura per app mobile future condividendo lo stesso backend. Non ha senso per un blog standard, per una landing page semplice, o per un ecommerce piccolo dove WooCommerce nativo funziona meglio del suo equivalente headless. Per piccoli progetti che vogliono comunque testare l’approccio, la combinazione WordPress + WPGraphQL + Next.js su Vercel è la più matura e la più documentata, con community italiana ancora piccola ma crescente sia su GitHub sia sui gruppi Telegram di sviluppatori dei principali hub tech nazionali.
Tre errori comuni nel setup WordPress headless
Il primo errore che vediamo su piccoli progetti headless è sottostimare la complessità operativa. Un’installazione headless significa gestire due deployment separati (WordPress su un hosting, frontend su Vercel o Netlify), due sistemi di monitoraggio, due catene di CI, doppio SSL, doppie procedure di backup. Per una PMI italiana con budget contenuto questa complessità va valutata prima. Il secondo errore è pensare che tutti i plugin WordPress continuino a funzionare come nel frontend classico. Molti plugin generano output PHP legato al tema che nel setup headless viene semplicemente ignorato. Yoast SEO in headless richiede il plugin add-on WPGraphQL for Yoast SEO per esporre i dati corretti al frontend. Contact Form 7 funziona ma richiede un endpoint custom per la submission via GraphQL Mutation. Il terzo errore è la gestione delle preview: i redattori WordPress si aspettano di vedere l’anteprima del contenuto prima di pubblicare. In un setup headless serve configurare le preview stateful con Next.js Draft Mode o equivalenti, altrimenti il team marketing perde una funzione critica e la migrazione headless viene percepita come un downgrade.
Costi e tempi realistici di un progetto headless piccolo
Per un piccolo progetto headless (sito vetrina o piccolo catalogo B2B di una PMI italiana) i costi di infrastruttura si distribuiscono su tre livelli. Hosting WordPress backend: 15-40 euro al mese su un piano managed decente per WordPress non pubblico direttamente, quindi senza necessità di ottimizzazione frontend. Vercel o Netlify per il frontend Next.js: piano gratuito sufficiente sotto i 100.000 pageview al mese, poi 20 dollari al mese per il piano Pro. Backup e CDN già inclusi nei piani. Il costo dominante è lo sviluppo. Il setup iniziale del sistema headless (installazione plugin, configurazione GraphQL, creazione template frontend base, integrazione preview) richiede otto-dodici giornate di lavoro per uno sviluppatore full stack, con budget fra 4.500 e 8.500 euro. Il porting effettivo dei contenuti e la creazione di tutte le pagine del sito aggiungono altri quindici-venti giorni di lavoro, portando il totale a 12.000-18.000 euro per un piccolo progetto completo. I tempi calendariali sono otto-dodici settimane. La manutenzione è più economica rispetto a un WordPress tradizionale ma richiede competenze specifiche di JavaScript moderno.
Caso pratico: piccolo progetto B2B veronese con WPGraphQL
Nel primo trimestre 2026 abbiamo lavorato con una piccola realtà B2B veronese (12 dipendenti, settore soluzioni IoT industriali) per creare il loro nuovo sito con approccio headless. Il progetto è nato dalla richiesta esplicita del CTO cliente di avere un sito con performance eccellenti (LCP sotto 1 secondo) e un frontend Next.js che potesse diventare in futuro anche l’app mobile del prodotto. Abbiamo installato WordPress con WPGraphQL, WPGraphQL for ACF (per esporre i custom field), WPGraphQL for Yoast SEO. Il frontend è stato costruito con Next.js 15 su Vercel Pro. Il progetto ha incluso 18 pagine, un catalogo di 45 prodotti con schede tecniche complete, un blog editoriale e un form di richiesta demo. Budget totale 14.500 euro, timeline dieci settimane. I risultati misurati dopo il go-live sono stati eccezionali: LCP di 0,8 secondi su mobile 4G, Core Web Vitals tutti verdi, traffico organico cresciuto del quarantasette percento nei primi tre mesi dopo il lancio. Il vero valore aggiunto per il cliente non è stato solo la performance ma il fatto che il frontend è stato riutilizzato al sessanta percento per l’app mobile lanciata quattro mesi dopo, con un risparmio stimato di circa 15.000 euro di sviluppo aggiuntivo.
Come decidere se il tuo progetto vuole approccio headless
Se stai valutando WordPress headless con WPGraphQL per un piccolo progetto B2B italiano il primo test è misurare il valore reale delle performance. Se il tuo cliente compete su ricerca organica in un settore competitivo, ogni frazione di secondo di miglioramento sui Core Web Vitals si traduce in traffico aggiuntivo misurabile e headless offre un vantaggio concreto. Il secondo test è valutare le competenze presenti in agency: senza almeno uno sviluppatore full stack solido su JavaScript moderno, la scelta headless diventa un rischio operativo. Il terzo test è la roadmap a due anni: se il cliente prevede sviluppo di app mobile, dashboard interne, o integrazioni con sistemi esterni, il backend WordPress headless diventa un asset riutilizzabile che ripaga rapidamente. Fai i tre test prima di partire.
