WordPress headless + Next.js: un piano d’azione per il 2026

Cosa significa headless

In una configurazione headless, WordPress resta il luogo in cui i redattori scrivono e gestiscono i contenuti, ma non genera più il sito pubblico. Un front end separato, in questo caso Next.js, recupera i contenuti tramite la REST API di WordPress o WPGraphQL e costruisce le pagine.

I vantaggi sono velocità, sicurezza (l’admin di WordPress può stare su un indirizzo privato), libertà di design e la possibilità di inviare gli stessi contenuti a un sito, ad app e ad altri canali. I costi sono due sistemi da ospitare e mantenere, e le funzioni che normalmente forniscono temi e plugin di WordPress vanno ricostruite nel front end.

Quando ne vale la pena

• Grandi siti di contenuti ed editori, dove velocità e scala contano.
• Brand che hanno bisogno di un front end molto personalizzato, simile a un’app.
• Contenuti condivisi tra sito web, app mobile e altri canali.
• Team che hanno già sviluppatori React o Next.js.

Per un sito vetrina o una piccola attività con poche pagine, un tema WordPress tradizionale ben fatto è di solito più economico e altrettanto veloce.

Rendering: pagine statiche sempre aggiornate

Genera le pagine in modo statico e servile da una CDN, così i visitatori ricevono l’HTML all’istante. Invece di ricostruire l’intero sito, usa la revalidation on demand: quando un redattore pubblica o aggiorna un articolo, un piccolo hook di WordPress chiama un endpoint segreto in Next.js, che riconvalida solo le pagine o i tag interessati. I contenuti sono online in pochi secondi e le pagine restano veloci.

// app/api/revalidate/route.js — called by WordPress on publish
import { revalidateTag } from 'next/cache';

export async function POST(request) {
  const { secret, tag } = await request.json();
  if (secret !== process.env.REVALIDATE_SECRET) {
    return Response.json({ ok: false }, { status: 401 });
  }
  revalidateTag(tag);
  return Response.json({ ok: true });
}

Anteprime per i redattori

I redattori si aspettano che il pulsante Anteprima funzioni. Usa la draft mode di Next.js: WordPress rimanda a una route di anteprima con un segreto e l’ID dell’articolo, la route attiva la draft mode e la pagina recupera l’ultima revisione con una richiesta autenticata (ad esempio con una application password o un token). Testa le anteprime per articoli non pubblicati, articoli programmati e pagine con campi personalizzati.

SEO in un progetto headless

• Esponi tramite l’API i campi del plugin SEO (titolo, descrizione, canonical, immagine social, schema) e visualizzali nei metadata di Next.js.
• Genera la sitemap e il robots.txt dal front end, usando i contenuti di WordPress.
• Gestisci i redirect in WordPress e sincronizzali con il front end, così i redattori mantengono il controllo.
• Mantieni gli URL identici durante una migrazione, oppure reindirizza ogni vecchio URL.

Immagini, moduli e ricerca

Servi i media di WordPress tramite l’ottimizzazione immagini di Next.js o una CDN per immagini, con il dominio dei media di WordPress consentito nella configurazione. I moduli hanno bisogno di una destinazione: inviali a una route di Next.js che li convalida e li inoltra al tuo CRM o alla tua email, oppure usa l’API di un plugin per moduli. La ricerca interna di solito passa a un servizio dedicato o a un semplice endpoint API, perché la pagina di ricerca del tema non esiste più.

Le insidie che pianifichiamo

• I page builder salvano il layout come shortcode o markup proprietario, difficile da visualizzare altrove; preferisci blocchi Gutenberg o campi personalizzati.
• Menu, widget e funzioni dei plugin che dipendono da un tema hanno bisogno di equivalenti via API.
• Proteggi l’admin di WordPress e disattiva il tema pubblico per evitare contenuti duplicati.
• I contenuti multilingue richiedono un plugin con supporto API e una strategia di URL chiara in Next.js.

Una checklist prima di iniziare

Concorda il modello dei contenuti (tipi di post, campi, blocchi), come funzionano anteprime e pubblicazione, dove si trovano redirect e campi SEO, come vengono gestiti moduli e ricerca e chi ospita e monitora ciascuna delle due parti. Con queste decisioni prese in anticipo, WordPress headless offre ai redattori lo strumento che conoscono e ai visitatori un sito veloce ovunque.