Wat Shopware Headless technisch betekent, welke frontendopties in 2026 nog worden onderhouden (Shopware Frontends, Next.js, niet meer Shopware PWA), wat een eigen frontend kost en wanneer de Storefront volstaat.
Shopware 6 is van huis uit geschikt voor headless. De Store API levert producten, winkelwagen, checkout en klantaccount als JSON, oftewel in een machineleesbaar formaat, en de meegeleverde Storefront gebruikt intern dezelfde routes. Een eigen frontend is daarom een optie, geen verplichting.
Headless loont voor enkele, duidelijk afgebakende gevallen: meerdere kanalen vanuit één backend, merken met een zeer groot aandeel content, apps en portalen of een ontwikkelteam dat sowieso met Vue of React werkt.
Reken op minstens 40.000 € voor het frontend en daarna op twee systemen in het lopende beheer. Voor de meeste handelaren tot ver in de zeven cijfers omzet is de Shopware Storefront met een eigen thema de voordeligere keuze.
Een eigen frontend belooft ontwerpvrijheid en snelheid, maar kost een veelvoud van een thema en verdubbelt het beheer. Dit artikel is bedoeld voor directeuren en e-commercemanagers die voor een platform- of relaunchbeslissing staan, en voor handelaren die naast de webshop een app, een portaal of extra merkpresentaties plannen.
Na het lezen kunt u beslissen of Storefront, hybride of headless bij uw webshop past, kent u de frontendopties die in 2026 worden onderhouden en kunt u budget, team en projectverloop realistisch plannen.
Vóór de oprichting van solution25 hebben wij zelf een webshop beheerd en naar meer dan 500 bestellingen per dag gebracht. Sinds 2017 realiseren wij Shopware-projecten, zowel met de klassieke Storefront als met ontkoppelde frontends op basis van de Store API. Kosten en teambehoefte zijn ervaringswaarden uit onze projecten, alle prijzen per oktober 2026, exclusief btw.
Rond Shopware Headless worden drie begrippen vaak door elkaar gehaald. Ze beschrijven echter verschillende dingen, en het onderscheid bepaalt later budget en team.
“Headless” betekent letterlijk “zonder hoofd”. Bedoeld is een systeem zonder vast verbonden presentatielaag. Een headless webshop is dus geen webshop zonder interface, maar een webshop waarvan de interface uitwisselbaar is.
Shopware noemt de kern van Shopware 6 zelf “Headless Core” en stelt in zijn kennisbank headless en composable commerce gelijk. Voor de planning loont het onderscheid: composable betekent meer systemen, meer contracten en meer koppelingen.
Shopware 6 biedt twee koppelingen die in een headless-project verschillende taken hebben. De verschillen, ook met GraphQL, leggen wij uitgebreid uit onder GraphQL en REST-API’s in Shopware.
| Koppeling | Doel | Toegang | Typische gebruikers |
|---|---|---|---|
| Store API | Alles wat een klant in de webshop doet: producten, categorieën, zoeken, winkelwagen, checkout, klantaccount, Erlebniswelten (Shopping Experiences), SEO-URL’s | Openbaar per verkoopkanaal (header sw-access-key), sessie via de header sw-context-token | Headless-frontends, apps, terminals |
| Admin API | Beheer van alle data: producten aanmaken, bestellingen opvragen, klanten, media, configuratie | OAuth-toegang via integraties of gebruikers, pad /api | ERP, PIM, middleware, eigen tools |
De Store API bevindt zich onder het pad /store-api en is afgestemd op frontends: hij geeft alleen data vrij die voor klanten bestemd zijn, en werkt zowel voor gasten als voor ingelogde klanten. Elke aanroep bevat de toegangssleutel van het verkoopkanaal in de header sw-access-key.
De sessie loopt via de header sw-context-token. Die houdt winkelwagen, aanmelding, taal, valuta en betaalmethode bij elkaar, zonder dat de server een klassieke sessie nodig heeft. Hoe dat in detail werkt, staat in onze woordenlijst onder context-token.
De belangrijkste routes laten zien hoe volledig de koppeling is: POST /store-api/product voor lijsten en zoeken, POST /store-api/checkout/cart/line-item voor de winkelwagen, POST /store-api/account/login voor klanten, POST /store-api/checkout/order voor de bestelling. Ook SEO-URL’s en CMS-pagina’s komen uit de Store API, zodat een headless-frontend dezelfde paden kan gebruiken als de Storefront.
Een detail dat veel discussies ontkracht: de meegeleverde Twig-Storefront roept intern dezelfde Store API-routes aan die een headless-frontend van buitenaf gebruikt. Shopware beschrijft dat in zijn architectuurdocumentatie uitdrukkelijk zo. De Storefront is daarmee technisch al een afnemer van de API, alleen in PHP en op dezelfde server.
Wie headless gaat, krijgt dus geen andere databasis en geen andere functies, maar een andere presentatielaag met een andere stack, andere hosting en een ander team.
In de administratie maakt u voor een eigen frontend een verkoopkanaal van het type “Headless” aan, met een eigen toegangssleutel, eigen domeinen, talen, valuta en betaalmethoden. Zo draaien webshop, app en B2B-portaal parallel op één backend, desgewenst met gescheiden assortimenten en prijzen.
De vraag waarmee het frontend wordt gebouwd, is de afgelopen drie jaar duidelijker geworden. Enkele opties uit oudere artikelen zijn stopgezet.
| Optie | Stack | Onderhouden door | Stand oktober 2026 |
|---|---|---|---|
| Shopware Frontends (Composable Frontends) | Vue 3, Nuxt 4, TypeScript | Shopware, MIT-licentie | Officiële oplossing, Vue Starter Template als productierijpe basis |
| Next.js Shopware Starter | React, Next.js App Router, Tailwind | Shopware Labs, template bij Vercel | Referentieproject zonder geïntegreerde checkout |
| Eigen bouw met @shopware/api-client | Willekeurig JavaScript-framework, ook Astro, Svelte of Angular | Shopware (pakket), project (frontend) | Getypeerde client, types uit het OpenAPI-schema van de eigen webshop |
| Shopware PWA (met Vue Storefront) | Vue 2, Nuxt 2 | Niemand meer | Repository sinds 31 oktober 2024 gearchiveerd, Alokai voert Shopware niet als integratie |
Shopware Frontends, in de marketing Composable Frontends genoemd, is het eigen framework van Shopware voor headless-storefronts. Het bestaat uit meerdere npm-pakketten: @shopware/api-client (frameworkonafhankelijk), @shopware/helpers, @shopware/composables met ongeveer 60 Vue-composables zoals useCart, useUser of useListing, de Nuxt-module en het pakket cms-base-layer, dat de Erlebniswelten (Shopping Experiences) uit het Shopware-CMS rendert.
Shopware adviseert als startpunt het Vue Starter Template op Nuxt 4 met Server-Side Rendering, meertaligheid en gegenereerde TypeScript-types. Het bevat bewust geen kant-en-klare webshopinterface: navigatie, productpagina’s, winkelwagen, checkout en klantaccount stelt het project zelf samen uit de composables.
Belangrijk voor teams die in 2023 of 2024 zijn gestart: het vroegere Demo Store Template is volgens de documentatie uitgefaseerd en niet bedoeld voor productief gebruik. Daarnaast is er een Astro-template en een leeg template zonder UI-pakket.
Vereisten zijn Node.js 22 (LTS) en een Shopware 6-instantie, zelf gehost of als SaaS. Het framework is open source onder MIT-licentie, en op de prijspagina van Shopware is headless geen kenmerk van een plan: Store API en Frontends zijn ook met de Community Edition beschikbaar.
Voor React-teams stelt Shopware Labs een Next.js Shopware Starter bij Vercel beschikbaar: App Router, React Server Components, Server Actions, Tailwind, gekoppeld via @shopware/api-client. De starter levert geen kant-en-klare checkout. Projecten sturen óf door naar de checkout van de Shopware Storefront óf bouwen de checkout zelf via de Store API.
Shopware PWA, in 2020 samen met Vue Storefront gestart, was de eerste headless-aanpak van Shopware. In december 2022 kondigde Shopware aan het project over te brengen naar Shopware Frontends, en op 31 oktober 2024 werd de repository gearchiveerd, met verwijzing naar Composable Frontends als opvolger.
Vue Storefront heet tegenwoordig Alokai. In de integratielijst van Alokai staan SAP Commerce Cloud, commercetools, Adobe Commerce, BigCommerce, Salesforce Commerce Cloud, plentysystems en Odoo, maar geen Shopware. Wie vandaag “Vue Storefront voor Shopware” plant, plant met een stand van 2022.
Bestaande PWA-projecten hebben een migratiepad naar Shopware Frontends nodig, want Nuxt 2 als basis van Shopware PWA krijgt volgens nuxt.com sinds 30 juni 2024 geen beveiligingscorrecties meer.
Composable wordt het wanneer de content uit een eigen systeem komt. Shopware documenteert voor Frontends de koppeling met Storyblok, Strapi en Sanity en noemt Contentful, Hygraph en Builder.io als compatibel. Aanbevolen wordt dat het CMS redactionele pagina’s levert, Shopware prijzen, voorraden en checkout behoudt en de Erlebniswelten als terugvaloptie dienen voor routes die het CMS niet kent.
De voordelen zijn reëel, maar gelden alleen als het project ze benut. Een headless-frontend dat dezelfde webshoppagina in een andere stack nabouwt, heeft er geen enkele van.
De nadelen staan minder vaak in artikelen, omdat ze pas in het project zichtbaar worden. Zes punten laten de budgetten volgens onze ervaring ontsporen.
De volgende cijfers zijn ervaringswaarden uit bureauprojecten, geen lijstprijzen. De licentie van Shopware verandert door headless niet: Community Edition 0 €, Rise vanaf 600 €, Evolve vanaf 2.400 € per maand volgens de prijspagina. Wat een Shopware-project in totaal kost, hebben wij uitgesplitst onder kosten van Shopware.
| Post | Storefront met eigen thema | Headless-frontend |
|---|---|---|
| Frontendimplementatie, eenmalig | 5.000 tot 30.000 € (thema) | 40.000 tot 120.000 €, zelden lager |
| Nabouw van plugininterfaces | vervalt | 10.000 tot 30.000 €, afhankelijk van het aantal |
| Doorlooptijd tot de go-live | 6 tot 16 weken | 4 tot 9 maanden |
| Hosting per maand | 50 tot 1.500 € voor de webshop | Webshop zoals links, plus 50 tot 500 € voor het frontend |
| Onderhoud en doorontwikkeling per maand | 400 tot 2.500 € | 1.500 tot 5.000 € |
| Team tijdens beheer | Shopware-bureau volstaat | Frontendontwikkelaar (Vue of React), Shopware-ontwikkelaar, DevOps |
De bandbreedte bij het frontend verklaart zich uit de verplichte omvang: catalogus, zoeken, winkelwagen, checkout, klantaccount, CMS-rendering, tracking, consent en SEO heeft elke webshop nodig, hoe klein ook. Daarom daalt de prijs bij kleine webshops nauwelijks. De gebruikelijke projectkosten voor Shopware zelf, koppelingen en datamigratie komen daar nog bij.
Als vuistregel uit onze projecten: onder ongeveer 2 mln. € jaaromzet of zonder een tweede kanaal met een eigen interface verdient een headless-frontend zijn kosten zelden terug.
Afbeelding: De grafiek toont de eenmalige frontendkosten per variant; bij headless komt de nabouw van de plugininterfaces erbij, daarom rendeert deze weg meestal pas met een tweede kanaal. Ervaringswaarden solution25 uit bureauprojecten, stand oktober 2026, exclusief btw.
De Storefront van Shopware 6 is een server-side gerenderde applicatie op Twig, Bootstrap en SCSS, met themasysteem, Erlebniswelten, Rule Builder en Flow Builder. Voor de meeste handelaren is het niet de “oude” variant, maar die met de beste verhouding tussen functie en kosten.
Tussen Storefront en volledige uitbouw bestaan tussenstappen die vaak het gewenste effect opleveren. Een merkpagina of een magazine in Nuxt of een headless CMS, terwijl catalogus, checkout en account in de Storefront blijven. Een app die via de Store API bestelt, naast de webshop. Een configurator als Vue-component binnen de Storefront.
Het voordeel: de checkout met alle betaalmethoden, juridische teksten en plugins blijft zoals hij is. De prijs: overgangen tussen beide werelden (winkelwagen, aanmelding, tracking) moeten zorgvuldig worden opgelost, anders raken klanten onderweg hun winkelwagen kwijt.
Uit projecten en aanvragen van de afgelopen jaren zijn vijf patronen naar voren gekomen waarbij de rekensom klopt.
Daar hoort de klassieke B2C-webshop met enkele duizenden producten, één taal en één kanaal niet bij. Die wordt door headless niet sneller, niet mooier en niet omzetsterker, alleen duurder.
Foleja, een grensoverschrijdende marktplaats in Zuidoost-Europa, draait op een modulaire Shopware 6-architectuur voor meerdere landen, valuta en meer dan 1.000 verkopers. Bij het project hoorden native apps voor iOS en Android met gesynchroniseerde product-, bestel- en notificatiedata, oftewel een tweede kanaal met een eigen interface zoals in het eerste patroon hierboven.
Volgens de case study verhoogden de apps het aantal dagelijks actieve gebruikers en het herhaalaankooppercentage, in totaal lag de conversieratio 20 tot 30 procent hoger. De case laat zien waar het werk aan koppelingen zich terugbetaalt: bij een kanaal dat zonder die koppelingen niet zou bestaan.
| Criterium | Storefront (Twig) | Hybride | Headless (Frontends of Next.js) |
|---|---|---|---|
| Budget voor het frontend | 5.000 tot 30.000 € | 15.000 tot 50.000 € | vanaf 40.000 € |
| Tijd tot de go-live | 6 tot 16 weken | 2 tot 5 maanden | 4 tot 9 maanden |
| Team tijdens beheer | Shopware-bureau | Bureau plus frontendontwikkelaar | Eigen team of bureau met JavaScript-focus |
| Store-plugins met interface | Werken direct | Werken in de Storefront, niet in het ontkoppelde deel | Moeten worden nagebouwd |
| Erlebniswelten | Volledig, met preview | In de Storefront volledig | Rendering via cms-base-layer, preview zelf bouwen |
| Tweede kanaal (app, terminal) | Mogelijk via de Store API, gescheiden van de webshop | Ja, dat is het doel | Ja, met gedeelde componenten |
| Ontwerpvrijheid | Hoog, binnen de paginastructuur | Hoog in de ontkoppelde delen | Zonder beperkingen |
| Risico bij updates | Thema en plugins testen | Beide plus de overgangen | Wijzigingen in de Store API testen, frontendafhankelijkheden onderhouden |
| Geschikt voor | De meeste B2C- en B2B-webshops | Contentmerken, webshops met app | Multichannel, multibrand, portalen, JavaScript-teams |
Onze inschatting: Zonder tweede kanaal met een eigen interface raden wij een volledig headless-frontend af en steken het budget liever in thema, hosting en het opschonen van plugins. Komt er een app, een portaal of een extra merkpresentatie bij, dan adviseren wij Shopware Frontends op Nuxt, omdat Shopware het framework zelf onderhoudt en het de Erlebniswelten kan renderen. Wie stapsgewijs te werk wil gaan, laat de checkout eerst in de Storefront, want daar werken betaalmethoden, juridische teksten en plugins al.
Leg de waarden vier weken vóór de overstap vast als basis, meet in de eerste acht weken daarna wekelijks en vervolgens maandelijks.
Bijsturen is nodig als klikken of conversieratio na acht weken onder de basis liggen, de Store API bij piekbelasting trager reageert of de beheerkosten boven één procent van de omzet blijven. Dan helpen meestal caching, ontbrekende redirects of een slankere functieomvang.
Headless commerce, ook headless e-commerce genoemd, scheidt de interface van een webshop van het shopsysteem. Het shopsysteem levert producten, prijzen, winkelwagen en bestellingen via koppelingen, de interface wordt apart ontwikkeld en kan een website, een app of een terminal zijn. Shopware 6 ondersteunt dat via de Store API.
Letterlijk “zonder hoofd”. Het “hoofd” is de presentatielaag, oftewel wat klanten zien. Een headless-systeem heeft geen vast verbonden hoofd, maar kan met elk frontend worden verbonden.
Shopware 6 is API-first gebouwd en daarmee geschikt voor headless, maar niet uitsluitend headless. De meegeleverde Storefront gebruikt intern dezelfde Store API-routes die een eigen frontend zou gebruiken. U beslist per verkoopkanaal of de Storefront of een eigen frontend de interface levert.
Headless ontkoppelt alleen het frontend van het shopsysteem. Composable commerce stelt daarnaast andere bouwstenen zoals CMS, zoeken of betaling samen uit gespecialiseerde diensten. Shopware gebruikt beide begrippen naast elkaar, voor de calculatie is composable de duidelijk grotere stap.
Hogere implementatiekosten, twee systemen in beheer, Store-plugins zonder frontenddeel, de nabouw van checkout, SEO en consent en de blijvende afhankelijkheid van frontendontwikkelaars. Wie deze punten niet inplant, betaalt ze later in het beheer.
Voor het frontend rekenen wij met 40.000 tot 120.000 € implementatie, zelden minder, plus 10.000 tot 30.000 € voor de nabouw van plugininterfaces. In het beheer komen daar 1.500 tot 5.000 € per maand voor het onderhoud van beide systemen en 50 tot 500 € voor de frontendhosting bij. Deze waarden zijn ervaringswaarden uit bureauprojecten, geen lijstprijzen.
De backendlogica wel, de interface niet. Een betaalplugin verwerkt betalingen nog steeds via de Store API, maar zijn Twig-template en zijn JavaScript verschijnen niet in het eigen frontend. Elke plugin met een interface moet in het frontend worden nagebouwd.
Alleen met Server-Side Rendering, correcte canonicals, redirects en een sitemap. Dan rankt een headless-frontend zoals elke andere site en profiteert het van korte laadtijden. Zonder dit werk verliest een webshop bij de overstap de rankings die hij met de Storefront had.
U plant een eigen frontend, een app of een tweede kanaal op Shopware en wilt vooraf weten wat dat kost en of de Storefront niet volstaat? Schrijf ons. Wij controleren plugins, kanalen en team en zeggen het u ook als headless voor u de duurdere oplossing zonder meerwaarde zou zijn.
U beheert al een webshop en overweegt of laadtijd of design een nieuw frontend rechtvaardigen? Onze gratis shopanalyse laat zien waar de huidige webshop omzet verliest en of een headless-project of een optimalisatie van de Storefront de betere weg is.
Meer over onze werkwijze, certificeringen en vestigingen leest u op de pagina Shopware-bureau solution25.
Besnik Bilalli is oprichter en CEO van solution25, het Shopware-bureau uit Bremen. Vóór de oprichting van het bureau in 2017 heeft hij zelf een webshop opgebouwd en naar meer dan 500 bestellingen per dag gebracht. Sindsdien begeleidt hij handelaren bij Shopware-projecten, van de eerste calculatie tot het lopende beheer. Vragen over het artikel beantwoordt hij graag persoonlijk: neem contact op.
Verantwoordelijk voor inhoud en actualisering: Besnik Bilalli. Stand: oktober 2026. Volgende inhoudelijke controle: januari 2027.
