Wat is de WordPress onderhoudsmodus?

De WordPress onderhoudsmodus is een ingebouwde functie die je website tijdelijk offline haalt voor bezoekers terwijl jij updates uitvoert of aanpassingen doorvoert. WordPress schakelt deze modus automatisch in tijdens het updaten van de core, thema’s of plugins, en zet hem weer uit zodra het proces klaar is. In de meeste gevallen duurt dat slechts enkele seconden. In dit artikel beantwoorden we de meest gestelde vragen over hoe de onderhoudsmodus werkt, wat je doet als hij vastloopt, en wanneer je hem zelf handmatig inschakelt.

Wanneer schakelt WordPress automatisch over naar de onderhoudsmodus?

WordPress schakelt automatisch over naar de onderhoudsmodus op het moment dat je een update start vanuit het dashboard. Dat geldt voor updates van de WordPress core, geïnstalleerde thema’s en plugins. Tijdens die update worden een aantal achtergrondprocessen tijdelijk stilgezet. Bezoekers zien dan de melding: “Briefly unavailable for scheduled maintenance. Check back in a minute.”

De onderhoudsmodus werd geïntroduceerd in WordPress versie 3.0 en is sindsdien een standaard onderdeel van de kern. De modus is bewust ontworpen om kort te duren. In de meeste gevallen is het voorbij binnen enkele tientallen seconden. Hoe lang precies hangt af van het aantal updates en de grootte van de bestanden die worden bijgewerkt.

Normaal gesproken merk je als beheerder weinig van deze automatische omschakeling. Alleen bezoekers die op precies dat moment de website proberen te laden, zien de melding. Zodra de update klaar is, verdwijnt de onderhoudsmodus vanzelf en is de site weer bereikbaar.

Hoe werkt de onderhoudsmodus technisch gezien?

Technisch gezien werkt de WordPress onderhoudsmodus via een tijdelijk bestand genaamd .maintenance. WordPress plaatst dit bestand in de rootmap van je installatie zodra een update begint. Zolang dat bestand aanwezig is en de tijdstempel ervan niet ouder is dan tien minuten, toont WordPress de onderhoudspagina aan bezoekers. Na de update verwijdert WordPress het bestand automatisch.

Het bestand bevat een PHP-variabele met het tijdstip waarop het werd aangemaakt. De functie wp_is_maintenance_mode() controleert bij elk bezoek of dat bestand bestaat en of de tijdstempel recenter is dan tien minuten. Is de tijdstempel ouder, dan beschouwt WordPress de onderhoudsmodus als verlopen en laadt het de site gewoon.

Tijdens de onderhoudsmodus laadt WordPress opzettelijk zo min mogelijk bestanden. Er worden geen plugins of thema’s geladen, de database wordt niet aangesproken, en ook vertalingen blijven buiten beschouwing. Dit houdt de pagina licht en snel. Tegelijkertijd stuurt WordPress een HTTP 503-statuscode (Service Unavailable) naar zoekmachines, samen met een Retry-After: 600-header. Dat instrueert zoekmachines om het over tien minuten opnieuw te proberen, zodat de tijdelijke uitval geen gevolgen heeft voor je positie in de zoekresultaten.

Wil je de standaard onderhoudspagina vervangen door een eigen versie? Dat doe je door een bestand genaamd maintenance.php te plaatsen in de map /wp-content/. WordPress controleert automatisch of dat bestand bestaat en gebruikt het in plaats van de standaardmelding. Via WP-CLI kun je de modus ook handmatig in- en uitschakelen met de commando’s wp maintenance-mode activate en wp maintenance-mode deactivate.

Hoe los je een vastgelopen WordPress onderhoudsmodus op?

Een vastgelopen WordPress onderhoudsmodus los je op door het .maintenance-bestand handmatig te verwijderen uit de rootmap van je website. Dit bestand blijft staan wanneer een update wordt onderbroken, bijvoorbeeld doordat je het browsertabblad sloot, de server te traag reageerde, of een plugin conflicten veroorzaakte. Normaal gesproken duurt de onderhoudsmodus maximaal dertig tot zestig seconden. Duurt het langer, dan is er iets misgegaan.

Stap voor stap: zo verwijder je het .maintenance-bestand

Het bestand staat in dezelfde map als wp-config.php. Omdat het een verborgen bestand is, moet je in je FTP-programma of hostingpaneel de optie “verborgen bestanden weergeven” aanzetten. Volg daarna deze stappen:

1. Maak verbinding via FTP of open de bestandsbeheerder in je hostingpaneel.
2. Schakel verborgen bestanden in zodat het .maintenance-bestand zichtbaar wordt.
3. Verwijder het bestand uit de rootmap van je WordPress-installatie.
4. Leeg je browsercache en de cache van eventuele cachingplugins, zodat bezoekers niet nog steeds de onderhoudspagina zien.

Als verwijderen alleen niet genoeg is

Soms lost het verwijderen van het bestand het probleem niet volledig op. Dat kan betekenen dat een plugin conflicten veroorzaakt. In dat geval hernoem je de map /wp-content/plugins/ tijdelijk naar /wp-content/plugins_disabled/ via FTP. Laadt de site dan wel? Hernoem de map dan terug en activeer plugins één voor één om de boosdoener te vinden.

Zie je helemaal geen .maintenance-bestand maar laadt de site nog steeds niet? Dan is er waarschijnlijk sprake van een PHP-fout. Check in dat geval de foutlogboeken in je hostingpaneel. Verkeerde bestandsrechten kunnen er ook voor zorgen dat WordPress het bestand niet zelfstandig kan verwijderen, waardoor de modus vastloopt, ook als de update zelf wel is voltooid.

Om te voorkomen dat je hier überhaupt in terechtkomt, is het verstandig om plugins één voor één te updaten in plaats van allemaal tegelijk, en het browsertabblad nooit te sluiten tijdens een update. Controleer ook vooraf of plugins en thema’s compatibel zijn met jouw WordPress-versie. Meer over hoe je updates veilig uitvoert lees je in ons overzicht van WordPress onderhoud.

Wat is het verschil tussen de onderhoudsmodus en een coming soon-pagina?

Het verschil tussen de onderhoudsmodus en een coming soon-pagina zit in het doel en het technische gedrag. De onderhoudsmodus gebruik je wanneer een bestaande, live website tijdelijk offline is voor updates of aanpassingen. Een coming soon-pagina gebruik je wanneer een nieuwe website nog niet klaar is voor publicatie. Beide tonen een tijdelijke pagina, maar ze sturen heel andere signalen naar zoekmachines.

De onderhoudsmodus stuurt een HTTP 503-statuscode, wat zoekmachines vertelt: “deze uitval is tijdelijk, kom later terug.” Een coming soon-pagina kan juist wel geïndexeerd worden, wat nuttig is voor nieuwe websites die alvast een online aanwezigheid willen opbouwen. Gebruik je per ongeluk een coming soon-pagina terwijl je live website tijdelijk offline is, dan riskeert Google die pagina te indexeren als je hoofdsite. Andersom, als je de onderhoudsmodus activeert voor een nieuwe site die je wil lanceren, blokkeert Google de site volledig en bouw je geen enkele zichtbaarheid op.

Veel WordPress-plugins bundelen beide functies in één interface, zoals SeedProd en LightStart. Dat is handig, maar het betekent ook dat je bewust de juiste modus moet kiezen. De vuistregel is simpel: bestaande site tijdelijk offline = onderhoudsmodus, nieuwe site nog niet live = coming soon.

Hoe maak je een eigen onderhoudspagina in WordPress?

Een eigen onderhoudspagina maak je in WordPress door de standaardmelding te vervangen via een plugin, een aangepast drop-in bestand, of een stukje code. De makkelijkste route voor de meeste gebruikers is een plugin. Voor wie liever handmatig werkt, biedt WordPress ook directe technische opties.

Via een plugin

De meest gebruikte plugins voor de onderhoudsmodus zijn SeedProd en LightStart. SeedProd heeft meer dan een miljoen actieve installaties en biedt een drag-and-drop builder met een uitgebreide bibliotheek aan templates. Je bepaalt zelf welke gebruikersrollen of IP-adressen de onderhoudspagina omzeilen, zodat jij als beheerder gewoon kunt doorwerken terwijl bezoekers de onderhoudspagina zien. LightStart is een gratis alternatief dat integreert met de standaard WordPress-blokeditor, wat het laagdrempelig maakt als je al vertrouwd bent met Gutenberg.

Vergeet na het activeren of deactiveren van de onderhoudsmodus je cache te legen. Cachingplugins slaan pagina’s op en kunnen bezoekers anders nog steeds de onderhoudspagina tonen terwijl de site alweer live is.

Handmatig via een drop-in bestand

Wil je geen plugin gebruiken? Maak dan een bestand aan met de naam maintenance.php en plaats dat in de map /wp-content/. WordPress controleert automatisch of dit bestand bestaat en gebruikt het als vervanging voor de standaardmelding. Je hebt dan volledige controle over de HTML en CSS van de pagina.

Een andere handmatige methode is het aanmaken van een .maintenance-bestand in de rootmap van je WordPress-installatie, met daarin de PHP-code <?php $upgrading = time(); ?>. Verwijder je het bestand, dan is de onderhoudsmodus direct uitgeschakeld. Let op: de methode via functions.php van je thema is minder aan te raden, omdat je de code opnieuw moet toevoegen als je ooit van thema wisselt.

Wanneer is het slim om de onderhoudsmodus handmatig in te schakelen?

Het is slim om de onderhoudsmodus handmatig in te schakelen wanneer je wijzigingen doorvoert die de website tijdelijk kapot kunnen laten lijken of onvolledige content tonen aan bezoekers. Kleine aanpassingen zoals een typefout herstellen hebben de onderhoudsmodus niet nodig. Grotere ingrepen wel.

Situaties waarbij handmatig inschakelen zinvol is:

• Grote plugin- of thema-updates waarbij je compatibiliteit wil controleren voordat bezoekers de site zien.
• Ingrijpende designwijzigingen die het uiterlijk van de site tijdelijk onvolledig maken.
• Databasemigraties waarbij datastructuren worden aangepast en de site tussentijds instabiel kan zijn.
• Servermigraties, zodat de site in exact dezelfde staat wordt overgezet en bezoekersinteracties geen data beschadigen.
• Noodpatches bij beveiligingsincidenten, om te voorkomen dat bezoekers een gecompromitteerde site te zien krijgen terwijl je het probleem oplost.

Plan onderhoud bij voorkeur tijdens de uren met het minste verkeer. Dat beperkt de impact op bezoekers en voorkomt onnodige omzetderving bij webshops.

Voor ingrijpende ontwikkelwerkzaamheden, zoals het testen van een nieuw thema of het bouwen van nieuwe functionaliteiten, is een stagingomgeving de betere keuze. Dat is een privékopie van je live site waarop je veilig kunt bouwen en testen zonder dat bezoekers er iets van merken. WordPress biedt via WP-CLI ook directe controle over de onderhoudsmodus Deze link opent in een nieuw tabblad, wat handig is voor ontwikkelaars die updates automatiseren.

Een goed geconfigureerde onderhoudsmodus met een HTTP 503-statuscode heeft geen negatief effect op je zoekmachineposities. Het risico ontstaat pas als de modus te lang actief blijft. Zoekmachines kunnen de site dan als permanent onbeschikbaar beschouwen. Schakel de modus dus altijd tijdig weer uit en controleer achteraf of alles correct werkt.

De onderhoudsmodus is een kleine maar krachtige functie die grote problemen voorkomt. Wil je zeker weten dat updates, migraties en beveiligingspatches op jouw WordPress-website altijd goed verlopen? Bij Stuurlui nemen we dat beheer volledig van je over, van technische updates tot snelle support als er toch iets misgaat. Neem contact op en we kijken samen wat het beste past bij jouw situatie.