Er bestaan twee soorten jargon. Het eerste soort bestaat om indruk te maken. Het tweede bestaat omdat er iets nieuws is waar nog geen gewoon woord voor was. “Headless” hoort bij het tweede soort. Dat helpt je alleen weinig wanneer het woord voor het eerst in een offerte opduikt, tussen twee bedragen in, zonder uitleg.
Dit artikel legt uit wat een headless CMS is zonder één regel code. Wat het betekent als je maandag een prijs op je website wil aanpassen. Wat het betekent voor de mensen die de site bouwen. Waarom het je site sneller en veiliger maakt. En wanneer je er beter van afblijft, want dat komt vaker voor dan bureaus toegeven.
Wat headless eigenlijk betekent
Een klassiek CMS doet twee jobs tegelijk. Het bewaart je inhoud, teksten, foto's, prijzen, vacatures, en het bepaalt hoe die inhoud er op het scherm uitziet. Dat tweede stuk, de presentatie, heet in het jargon de “head”. In WordPress is dat je thema. In Drupal je template. Het zit vast aan de rest.
Een headless CMS knipt die twee jobs los. Het systeem bewaart je inhoud en geeft die netjes gestructureerd door via een API. Wat er daarna mee gebeurt, is niet meer zijn zaak. Een aparte website, in ons geval gebouwd in Next.js, haalt de inhoud op en beslist zelf hoe ze eruitziet.
Vergelijk het met een magazijn en een etalage. In een klassiek CMS zitten die in hetzelfde gebouw, en de indeling van het magazijn bepaalt mee hoe je etalage eruit kan zien. Bij headless is het magazijn een magazijn. De etalage bouw je apart, precies zoals je hem wil, en je kan hem herbouwen zonder één doos te verplaatsen.
| Klassiek CMS | Headless CMS | |
|---|---|---|
| Inhoud | In het CMS | In het CMS |
| Presentatie | Een thema, in hetzelfde systeem | Een aparte site, in Next.js |
| Uitbreiden | Met plugins | Met geschreven code |
| Meerdere kanalen | Zelden | Via de API |
Wat er verandert voor wie teksten aanpast
Minder dan je vreest. Je logt nog altijd in op een beheerscherm. Je klikt nog altijd op “Diensten”, kiest een pagina, past een tekst aan en klikt op bewaren. Er verschijnt een voorbeeldweergave. Er is een knop om te publiceren.
Het verschil zit in wat je níét meer krijgt: een pagebuilder waarmee je kolommen sleept, lettergroottes kiest en een knop rood maakt omdat het die dag zo uitkomt. In de plaats daarvan krijg je velden. Een veld voor de titel. Een veld voor de introtekst. Een lijst met blokken die de ontwerper heeft voorzien.
Dat voelt in de eerste week beperkter, en het is in het tweede jaar het beste wat je site is overkomen. Een site die na achttien maanden nog steeds op zijn eigen ontwerp lijkt, is bijna altijd een site waar de redacteur niet aan de opmaak kán. Je huisstijl blijft heel omdat het systeem hem bewaakt, niet omdat iemand oplet.
Je huisstijl blijft heel omdat het systeem hem bewaakt, niet omdat iemand oplet.
Wat je er wél bij krijgt, hangt af van het CMS. Payload, het systeem waar wij op bouwen, heeft versies en drafts ingebouwd: je kan aan een pagina werken zonder dat ze live staat, terugrollen naar een vorige versie, en zien wat er tussen twee versies veranderd is. Er is live preview, waarbij je je aanpassing naast de echte pagina ziet terwijl je typt. Het beheerscherm is vertaald in meer dan dertig talen.

Wat er verandert voor wie hem bouwt
Hier zit de grootste verschuiving, en ze verklaart de rest van dit artikel.
In een klassiek CMS bouw je binnen de regels van het systeem. Je thema moet praten zoals het CMS het wil, in de taal die het CMS spreekt, in de volgorde die het CMS oplegt. Wil je iets dat het systeem niet voorzien heeft, dan ga je erlangs. Dat lukt meestal. Netjes is het zelden.
Bij headless is de frontend een gewone applicatie. Wij schrijven hem in Next.js, met React-componenten die we zelf ontwerpen. Geen thema dat we buigen tot het past.
Het tweede verschil is even belangrijk en veel minder zichtbaar: het contentmodel is code.
Het contentmodel in TypeScript
Bij Payload beschrijf je in TypeScript welke velden een dienstpagina heeft, welke verplicht zijn en wie ze mag bewerken. Zo ziet dat eruit.
import type { CollectionConfig } from "payload";
export const Diensten: CollectionConfig = {
slug: "diensten",
admin: { useAsTitle: "titel" },
versions: { drafts: true },
access: {
read: () => true,
update: ({ req }) => req.user?.role === "redacteur",
},
fields: [
{ name: "titel", type: "text", required: true },
{ name: "intro", type: "textarea" },
{ name: "prijsVanaf", type: "number", min: 0 },
],
};Dat bestand zit in versiebeheer. Een collega kan het nalezen voor het gebouwd wordt. Je kan het testen. Je kan zien wie wat wanneer veranderd heeft, aan de structuur, niet alleen aan de inhoud.
Payload genereert daaruit automatisch het beheerscherm, een REST- en een GraphQL-API, authenticatie en toegangsrechten tot op veldniveau. De data zelf staat in een gewone database: Postgres, SQLite of MongoDB, naar keuze. Geen zwarte doos.
Het snelheidsargument
Een klassiek CMS bouwt je pagina op het moment dat een bezoeker erom vraagt. De server start, vraagt de database om je tekst, laadt het thema, laadt de plugins, plakt alles aan elkaar en stuurt het resultaat door. Elke keer opnieuw. Voor elke bezoeker. Caching verzacht dat, maar het verandert niets aan het principe.
Bij een headless opzet gebeurt dat werk vooraf. De pagina wordt gebouwd wanneer de inhoud verandert, niet wanneer iemand langskomt, en wordt daarna geserveerd vanaf een netwerk van servers dicht bij de bezoeker. Wat er naar de browser gaat, is grotendeels afgewerkt.
Het tweede effect is subtieler. Elke plugin in een klassiek CMS voegt zijn eigen CSS en JavaScript toe aan élke pagina, ook de pagina's waar die plugin niets doet. Vijftien plugins later sleept je homepage een formulierbibliotheek, een sliderscript en drie iconensets mee die niemand gebruikt. In een frontend die je zelf schrijft, staat er wat je erin hebt gezet.
Headless is niet automatisch snel
Het veiligheidsargument
Websites op grote, populaire CMS'en worden zelden gekraakt via het CMS zelf. De kern van die systemen wordt door veel mensen bekeken en snel gepatcht. Wat wél misgaat, zijn de uitbreidingen: een plugin die twee jaar geen update kreeg, een thema van een marktplaats, een module die iemand ooit installeerde voor één formulier en die er sindsdien gewoon staat.
Elke plugin is code van een vreemde die draait op jouw server, met toegang tot jouw database. Dat is geen verwijt aan pluginmakers. Het is gewoon wat een plugin ís. Hoe meer je er hebt, hoe meer deuren er zijn die iemand anders moet blijven sluiten.
Een headless opzet verkleint dat oppervlak op twee manieren. Er is geen marktplaats waar je met één klik onbekende code installeert, extra functionaliteit wordt geschreven, nagelezen en mee getest. En het beheerscherm staat los van de publieke site. Wat bezoekers zien, is in veel gevallen een voorgebouwde pagina zonder database erachter. Er valt weinig te forceren aan een pagina die er al staat.
Ook hier de nuance: headless is niet onkwetsbaar. Er zijn nog altijd afhankelijkheden, en die hebben nog altijd updates nodig. Het verschil is dat je er een stuk of tien bewust beheert in plaats van er vijftig te hopen.
Eén bron, meerdere kanalen
Omdat de inhoud via een API buitenkomt, kan meer dan één ding ze opvragen. In de praktijk, bij een KMO, ziet dat er zo uit.
- Je vacatures staan één keer in het CMS en verschijnen op je werkenbij-pagina én in de feed die een jobsite ophaalt.
- Je productspecificaties voeden de productpagina, de vergelijkingstabel en het PDF-datasheet dat je verkoper meeneemt.
- Je openingsuren staan op één plek en niet op vier pagina's die langzaam uit elkaar groeien.
- Een app, een schermdisplay in de toonzaal of een partnerwebsite haalt dezelfde inhoud op zonder dat iemand ze overtypt.
Dat laatste woord is het punt. Overtypen is waar fouten ontstaan, en het is werk waar niemand voor betaald wil worden.
In één zin
Wanneer headless overkill is
Wij bouwen headless. Dat maakt ons niet objectief, dus laat ons expliciet zijn over wanneer je het niet moet doen.
- Bij een kleine brochuresite die twee keer per jaar wijzigt. Vijf pagina's, een contactformulier, geen groeiplan. De winst in snelheid en beheer weegt niet op tegen wat het bouwen kost.
- Als er geen budget is voor onderhoud. Een custom frontend heeft iemand nodig die hem kent. Zonder die relatie sta je na twee jaar met code die niemand aandurft.
- Als je hele werking op één plugin draait die alleen voor WordPress bestaat. Een specifiek boekingssysteem, een koppeling met een Belgisch boekhoudpakket, een ledenadministratie. Dat namaken kost meer dan het waard is.
- Als je volgende week live moet. Een goed thema kopen en invullen is dan een verdedigbare beslissing. Geen mooie, wel een verdedigbare.
In die gevallen is een goed onderhouden WordPress geen compromis maar het juiste antwoord. Wie je iets anders vertelt, verkoopt iets.
Hoe wij het aanpakken
Wij bouwen op Payload CMS, met een frontend in Next.js, gehost op Vercel. Payload is open source, in TypeScript geschreven, en draait als onderdeel van dezelfde Next.js-applicatie als de website. Eén codebase, één deploy, één plek waar het contentmodel staat.
Het gevolg voor jou: het beheerscherm is gemaakt voor jouw site, met de velden die jouw pagina's echt hebben. Geen twintig instellingen die je moet negeren. Geen plugin die volgende maand van eigenaar verandert.
Wil je weten hoe dat er concreet uitziet in een beheerscherm, lees dan onze pagina over CMS-ontwikkeling. Twijfel je of je site er klaar voor is, plan dan een gesprek van een halfuur. Wij zeggen het ook wanneer het antwoord nee is.
