Che cosa significa Shopware headless dal punto di vista tecnico, quali opzioni di frontend sono mantenute nel 2026 (Shopware Frontends, Next.js, non più Shopware PWA), quanto costa un frontend proprietario e quando basta la Storefront. Guida per merchant in Italia.
Shopware 6 è headless di serie. La Store API fornisce prodotti, carrello, checkout e account cliente in JSON, cioè in un formato leggibile dalle macchine, e la Storefront inclusa utilizza internamente le stesse rotte. Un frontend proprietario è quindi un’opzione, non un obbligo.
L’approccio headless conviene in pochi casi ben definiti: più canali da un unico backend, brand con una forte componente di contenuti, app e portali oppure un team di sviluppo che lavora già con Vue o React.
Per il frontend preveda almeno 40.000 € e, in seguito, due sistemi da gestire in esercizio. Per la maggior parte dei merchant, anche in Italia e ben oltre il milione di euro di fatturato, la Storefront di Shopware con un tema personalizzato resta la scelta più economica.
Un frontend proprietario promette libertà di design e velocità, ma costa diverse volte un tema e raddoppia la gestione operativa. Questo articolo si rivolge ad amministratori delegati e responsabili e-commerce in Italia che devono decidere su una piattaforma o un relaunch, e ai merchant che, oltre al negozio online, pianificano un’app, un portale o altri siti di brand.
Al termine della lettura potrà valutare se al Suo shop servono la Storefront, una soluzione ibrida o un’architettura headless, conoscerà le opzioni di frontend mantenute nel 2026 e potrà pianificare in modo realistico budget, team e fasi del progetto.
Prima di fondare solution25 abbiamo gestito in prima persona un negozio online, portandolo a oltre 500 ordini al giorno. Dal 2017 realizziamo progetti Shopware, sia con la Storefront classica sia con frontend disaccoppiati basati sulla Store API, e seguiamo anche merchant italiani. Costi e fabbisogno di team sono valori di esperienza tratti dai nostri progetti; tutti i prezzi sono aggiornati a ottobre 2026, IVA esclusa.
Quando si parla di Shopware headless, tre termini vengono spesso confusi. Descrivono però cose diverse, e la distinzione incide poi su budget e team.
“Headless” significa letteralmente “senza testa”. Si intende un sistema senza un livello di presentazione collegato in modo fisso. Uno shop headless non è quindi uno shop senza interfaccia, ma uno shop la cui interfaccia è sostituibile.
Shopware stessa chiama il nucleo di Shopware 6 “Headless Core” e nella sua knowledge base equipara headless e composable commerce. In fase di pianificazione conviene però distinguerli: composable significa più sistemi, più contratti e più interfacce.
Shopware 6 mette a disposizione due interfacce che in un progetto headless svolgono compiti diversi. Le differenze, anche rispetto a GraphQL, sono spiegate in dettaglio in GraphQL e REST API in Shopware.
| Interfaccia | Scopo | Accesso | Utilizzatori tipici |
|---|---|---|---|
| Store API | Tutto ciò che un cliente fa nello shop: prodotti, categorie, ricerca, carrello, checkout, account cliente, Shopping Experiences, URL SEO | Pubblico per canale di vendita (header sw-access-key), sessione tramite l’header sw-context-token | Frontend headless, app, terminali |
| Admin API | Gestione di tutti i dati: creazione prodotti, lettura ordini, clienti, media, configurazione | Accesso OAuth tramite integrazioni o utenti, percorso /api | ERP, PIM, middleware, strumenti propri |
La Store API si trova nel percorso /store-api ed è pensata per i frontend: restituisce solo i dati destinati ai clienti e funziona sia per gli ospiti sia per i clienti registrati. Ogni chiamata contiene nell’header sw-access-key la chiave di accesso del canale di vendita.
La sessione passa per l’header sw-context-token, che tiene insieme carrello, login, lingua, valuta e metodo di pagamento senza che il server abbia bisogno di una sessione classica. Il funzionamento nel dettaglio è descritto nel nostro glossario alla voce Context token.
Le rotte principali mostrano quanto sia completa l’interfaccia: POST /store-api/product per elenchi e ricerca, POST /store-api/checkout/cart/line-item per il carrello, POST /store-api/account/login per i clienti, POST /store-api/checkout/order per l’ordine. Anche URL SEO e pagine CMS arrivano dalla Store API, così un frontend headless può usare gli stessi percorsi della Storefront.
Un dettaglio che smorza molte discussioni: la Storefront Twig inclusa richiama internamente le stesse rotte della Store API che un frontend headless usa dall’esterno. Shopware lo descrive esplicitamente nella sua documentazione sull’architettura. Tecnicamente la Storefront è quindi già un consumatore dell’API, solo in PHP e sullo stesso server.
Chi sceglie l’headless non ottiene quindi una base dati diversa né funzioni diverse, ma un altro livello di presentazione, con un altro stack, un altro hosting e un altro team.
Nell’amministrazione si crea per il frontend proprietario un canale di vendita di tipo “Headless”, con chiave di accesso, domini, lingue, valute e metodi di pagamento propri. In questo modo negozio online, app e portale B2B funzionano in parallelo su un unico backend, se necessario con assortimenti e prezzi separati.
La scelta della tecnologia per il frontend si è chiarita negli ultimi tre anni. Alcune opzioni citate in articoli meno recenti sono state dismesse.
| Opzione | Stack | Mantenuta da | Stato a ottobre 2026 |
|---|---|---|---|
| Shopware Frontends (Composable Frontends) | Vue 3, Nuxt 4, TypeScript | Shopware, licenza MIT | Soluzione ufficiale, Vue Starter Template come base pronta per la produzione |
| Next.js Shopware Starter | React, Next.js App Router, Tailwind | Shopware Labs, template su Vercel | Progetto di riferimento senza checkout integrato |
| Sviluppo su misura con @shopware/api-client | Qualsiasi framework JavaScript, anche Astro, Svelte o Angular | Shopware (pacchetto), progetto (frontend) | Client tipizzato, tipi generati dallo schema OpenAPI del proprio shop |
| Shopware PWA (con Vue Storefront) | Vue 2, Nuxt 2 | Nessuno | Repository archiviato dal 31 ottobre 2024, Alokai non elenca Shopware tra le integrazioni |
Shopware Frontends, chiamato nel marketing Composable Frontends, è il framework di Shopware per storefront headless. È composto da diversi pacchetti npm: @shopware/api-client (indipendente dal framework), @shopware/helpers, @shopware/composables con circa 60 composables Vue come useCart, useUser o useListing, il modulo Nuxt e il pacchetto cms-base-layer, che esegue il rendering delle Shopping Experiences del CMS di Shopware.
Come punto di partenza Shopware consiglia il Vue Starter Template su Nuxt 4, con server-side rendering, multilingua e tipi TypeScript generati. Volutamente non include un’interfaccia di shop pronta: navigazione, pagine prodotto, carrello, checkout e account cliente vengono composti dal progetto stesso a partire dai composables.
Importante per i team partiti nel 2023 o nel 2024: secondo la documentazione, il precedente Demo Store Template è deprecato e non è pensato per la produzione. Sono disponibili inoltre un template Astro e un template vuoto senza pacchetto UI.
I requisiti sono Node.js 22 (LTS) e un’istanza Shopware 6, in self-hosting o in SaaS. Il framework è open source con licenza MIT e nella pagina prezzi di Shopware l’headless non è una caratteristica legata al piano: Store API e Frontends sono disponibili anche con la Community Edition.
Per i team React, Shopware Labs mette a disposizione su Vercel un Next.js Shopware Starter: App Router, React Server Components, Server Actions, Tailwind, collegato tramite @shopware/api-client. Lo starter non include un checkout pronto. I progetti reindirizzano al checkout della Storefront di Shopware oppure sviluppano il checkout direttamente sulla Store API.
Shopware PWA, avviato nel 2020 insieme a Vue Storefront, è stato il primo approccio headless di Shopware. A dicembre 2022 Shopware ha annunciato di farlo confluire in Shopware Frontends e il 31 ottobre 2024 il repository è stato archiviato, con rimando a Composable Frontends come successore.
Oggi Vue Storefront si chiama Alokai. Nell’elenco delle integrazioni di Alokai figurano SAP Commerce Cloud, commercetools, Adobe Commerce, BigCommerce, Salesforce Commerce Cloud, plentysystems e Odoo, ma non Shopware. Chi oggi pianifica “Vue Storefront per Shopware” ragiona con lo stato dell’arte del 2022.
I progetti PWA esistenti hanno bisogno di un percorso di migrazione verso Shopware Frontends, perché Nuxt 2, base di Shopware PWA, secondo nuxt.com non riceve più correzioni di sicurezza dal 30 giugno 2024.
Si parla di composable quando i contenuti arrivano da un sistema dedicato. Per Frontends Shopware documenta il collegamento con Storyblok, Strapi e Sanity e indica Contentful, Hygraph e Builder.io come compatibili. La raccomandazione: il CMS fornisce le pagine editoriali, Shopware mantiene prezzi, disponibilità e checkout, e le Shopping Experiences fungono da livello di riserva per le rotte che il CMS non conosce.
I vantaggi sono reali, ma valgono solo se il progetto li sfrutta. Un frontend headless che ricostruisce la stessa pagina dello shop con un altro stack non ne ha nessuno.
Gli svantaggi compaiono più raramente negli articoli, perché emergono solo durante il progetto. Secondo la nostra esperienza, sei punti fanno saltare i budget.
I valori che seguono sono dati di esperienza tratti da progetti di agenzia, non prezzi di listino. La licenza Shopware non cambia con l’headless: Community Edition 0 €, Rise da 600 € e Evolve da 2.400 € al mese secondo il fornitore (pagina prezzi). Quanto costa nel complesso un progetto Shopware lo abbiamo dettagliato in Costi di Shopware.
| Voce | Storefront con tema personalizzato | Frontend headless |
|---|---|---|
| Realizzazione del frontend, una tantum | da 5.000 a 30.000 € (tema) | da 40.000 a 120.000 €, raramente meno |
| Ricostruzione delle interfacce dei plugin | non necessaria | da 10.000 a 30.000 €, a seconda del numero |
| Tempo fino al go-live | da 6 a 16 settimane | da 4 a 9 mesi |
| Hosting al mese | da 50 a 1.500 € per lo shop | shop come a sinistra, più da 50 a 500 € per il frontend |
| Manutenzione ed evoluzione al mese | da 400 a 2.500 € | da 1.500 a 5.000 € |
| Team in esercizio | è sufficiente un’agenzia Shopware | sviluppatori frontend (Vue o React), sviluppatori Shopware, DevOps |
L’ampiezza della forchetta per il frontend dipende dal perimetro obbligatorio: catalogo, ricerca, carrello, checkout, account cliente, rendering CMS, tracking, consenso e SEO servono a ogni shop, per quanto piccolo. Per questo nei piccoli shop il prezzo scende poco. A questi si aggiungono i consueti costi di progetto per Shopware stesso, le integrazioni e la migrazione dei dati.
Come regola empirica dai nostri progetti: sotto circa 2 milioni di euro di fatturato annuo, o senza un secondo canale con interfaccia propria, un frontend headless raramente ripaga i suoi costi. Vale anche per i merchant italiani.
Figura: il grafico mostra i costi una tantum del frontend per ciascuna variante; con l’headless si aggiunge la ricostruzione delle interfacce dei plugin, per questo la scelta di solito conviene solo con un secondo canale. Valori di esperienza solution25 da progetti di agenzia, aggiornati a ottobre 2026, IVA esclusa.
La Storefront di Shopware 6 è un’applicazione renderizzata lato server su Twig, Bootstrap e SCSS, con sistema di temi, Shopping Experiences, Rule Builder e Flow Builder. Per la maggior parte dei merchant non è la variante “vecchia”, ma quella con il miglior rapporto tra funzionalità e costi.
Tra Storefront e architettura completamente headless esistono livelli intermedi che spesso ottengono l’effetto desiderato. Un sito di brand o un magazine in Nuxt o in un headless CMS, mentre catalogo, checkout e account restano nella Storefront. Un’app che ordina tramite la Store API, accanto al negozio online. Un configuratore come componente Vue all’interno della Storefront.
Il vantaggio: il checkout, con tutti i metodi di pagamento, i testi legali e i plugin, resta com’è. Il prezzo da pagare: i passaggi tra i due mondi (carrello, login, tracking) vanno risolti con cura, altrimenti i clienti perdono il carrello lungo il percorso.
Dai progetti e dalle richieste degli ultimi anni sono emersi cinque schemi in cui i conti tornano, sia in Germania sia per i merchant in Italia.
Non rientra in questi casi il classico shop B2C con alcune migliaia di prodotti, una lingua e un canale. Con l’headless non diventa più veloce, più bello né più redditizio, solo più costoso.
Foleja, un marketplace transfrontaliero nell’Europa sudorientale, funziona su un’architettura Shopware 6 modulare per più paesi, valute e oltre 1.000 venditori. Il progetto comprendeva app native per iOS e Android con dati di prodotto, ordini e notifiche sincronizzati, cioè un secondo canale con interfaccia propria come nel primo schema descritto sopra.
Secondo il case study, le app hanno aumentato il numero di utenti attivi giornalieri e il tasso di riacquisto; complessivamente il tasso di conversione è risultato più alto di una percentuale compresa tra il 20 e il 30 per cento. Il caso mostra dove il lavoro sulle interfacce ripaga: in un canale che senza di esse non esisterebbe.
| Criterio | Storefront (Twig) | Ibrido | Headless (Frontends o Next.js) |
|---|---|---|---|
| Budget per il frontend | da 5.000 a 30.000 € | da 15.000 a 50.000 € | da 40.000 € |
| Tempo fino al go-live | da 6 a 16 settimane | da 2 a 5 mesi | da 4 a 9 mesi |
| Team in esercizio | Agenzia Shopware | Agenzia più sviluppatori frontend | Team interno o agenzia specializzata in JavaScript |
| Plugin dello Store con interfaccia | Funzionano subito | Funzionano nella Storefront, non nella parte disaccoppiata | Vanno ricostruiti |
| Shopping Experiences | Complete, con anteprima | Complete nella Storefront | Rendering tramite cms-base-layer, anteprima da sviluppare |
| Secondo canale (app, terminale) | Possibile tramite Store API, separato dal negozio online | Sì, è lo scopo | Sì, con componenti condivisi |
| Libertà di design | Alta, entro la struttura delle pagine | Alta nelle parti disaccoppiate | Senza vincoli |
| Rischio negli aggiornamenti | Testare tema e plugin | Entrambi, più i passaggi tra le parti | Testare le modifiche alla Store API, mantenere le dipendenze del frontend |
| Adatto a | La maggior parte degli shop B2C e B2B | Brand di contenuti, shop con app | Multicanale, multibrand, portali, team JavaScript |
La nostra valutazione: senza un secondo canale con interfaccia propria sconsigliamo un frontend completamente headless e preferiamo investire il budget in tema, hosting e pulizia dei plugin. Se si aggiunge un’app, un portale o un altro sito di brand, consigliamo Shopware Frontends su Nuxt, perché Shopware mantiene direttamente il framework ed è in grado di renderizzare le Shopping Experiences. Chi vuole procedere per gradi lascia inizialmente il checkout nella Storefront, dove metodi di pagamento, testi legali e plugin funzionano già.
Rilevi i valori nelle quattro settimane precedenti il passaggio come base, misuri ogni settimana nelle prime otto settimane successive e poi ogni mese.
Occorre intervenire se dopo otto settimane clic o tasso di conversione sono sotto la base, se la Store API risponde più lentamente nei picchi di carico o se i costi di gestione restano sopra l’uno per cento del fatturato. Di solito aiutano il caching, i redirect mancanti o un perimetro funzionale più snello.
L’headless commerce, detto anche headless e-commerce, separa l’interfaccia di uno shop dalla piattaforma e-commerce. La piattaforma fornisce prodotti, prezzi, carrello e ordini tramite interfacce, mentre l’interfaccia viene sviluppata separatamente e può essere un sito web, un’app o un terminale. Shopware 6 lo supporta tramite la Store API.
Letteralmente “senza testa”. La “testa” è il livello di presentazione, cioè ciò che vedono i clienti. Un sistema headless non ha una testa collegata in modo fisso e si può collegare a qualsiasi frontend.
Shopware 6 è costruito secondo il principio API-first ed è quindi predisposto per l’headless, ma non è esclusivamente headless. La Storefront inclusa utilizza internamente le stesse rotte della Store API che userebbe un frontend proprietario. Per ogni canale di vendita si decide se l’interfaccia è fornita dalla Storefront o da un frontend proprietario.
L’headless disaccoppia solo il frontend dalla piattaforma e-commerce. Il composable commerce combina inoltre altri elementi, come CMS, ricerca o pagamenti, da servizi specializzati. Shopware usa i due termini in parallelo, ma ai fini del budget il composable è un passo decisamente più grande.
Costi di realizzazione più alti, due sistemi da gestire, plugin dello Store senza parte frontend, la ricostruzione di checkout, SEO e consenso e la dipendenza permanente da sviluppatori frontend. Chi non pianifica questi punti li paga più tardi nella gestione.
Per il frontend stimiamo da 40.000 a 120.000 € di realizzazione, raramente meno, più da 10.000 a 30.000 € per ricostruire le interfacce dei plugin. In esercizio si aggiungono da 1.500 a 5.000 € al mese per la manutenzione di entrambi i sistemi e da 50 a 500 € per l’hosting del frontend, IVA esclusa. Sono valori di esperienza da progetti di agenzia, non prezzi di listino, e valgono anche per i progetti dei merchant in Italia.
La logica di backend sì, l’interfaccia no. Un plugin di pagamento continua a elaborare i pagamenti tramite la Store API, ma il suo template Twig e il suo JavaScript non compaiono nel frontend proprietario. Ogni plugin con interfaccia va ricostruito nel frontend.
Solo con server-side rendering, canonical corretti, redirect e una sitemap. In questo caso un frontend headless si posiziona come qualsiasi altra pagina e beneficia di tempi di caricamento brevi. Senza questo lavoro, con il passaggio lo shop perde i ranking che aveva con la Storefront.
Sta pianificando un frontend proprietario, un’app o un secondo canale su Shopware e vuole sapere prima quanto costa e se la Storefront non sia sufficiente? Ci scriva. Seguiamo merchant in Italia anche da remoto: analizziamo plugin, canali e team e Le diciamo apertamente anche quando l’headless sarebbe per Lei la soluzione più cara senza valore aggiunto.
Gestisce già uno shop e si chiede se tempi di caricamento o design giustifichino un nuovo frontend? La nostra analisi dello shop gratuita mostra dove lo shop attuale perde fatturato e se la strada migliore sia un progetto headless o un’ottimizzazione della Storefront.
Per saperne di più sul nostro metodo di lavoro, le certificazioni e le sedi visiti la pagina Agenzia Shopware solution25.
Besnik Bilalli è fondatore e CEO di solution25, l’agenzia Shopware con sede a Brema. Prima di fondare l’agenzia nel 2017 ha creato un negozio online, portandolo a oltre 500 ordini al giorno. Da allora affianca i merchant nei progetti Shopware, dal primo preventivo alla gestione operativa. Risponde volentieri di persona alle domande sull’articolo: contattaci.
Responsabile dei contenuti e dell’aggiornamento: Besnik Bilalli. Aggiornato a: ottobre 2026. Prossima revisione dei contenuti: gennaio 2027.
