Oplossing voor The theme is missing the style.css stylesheet in WordPress

Als je in WordPress een nieuw thema probeert te installeren en de melding The theme is missing the style.css stylesheet ziet, lijkt het alsof het thema kapot is. Soms staat er ook: The package could not be installed. The theme is missing the style.css stylesheet. In het Nederlands betekent dit meestal: Het thema mist de style.css stylesheet.

Deze fout komt vaak voor bij het uploaden van WordPress-thema’s. Gelukkig betekent het niet altijd dat er echt iets mis is met het thema. Vaak upload je per ongeluk het verkeerde zip-bestand, staat de themamap op de verkeerde plek of ontbreekt het bestand style.css in de hoofdmap van het thema.

In dit artikel leggen we stap voor stap uit wat style.css is, waarom WordPress dit bestand nodig heeft en hoe je de foutmelding The theme is missing the style.css stylesheet kunt oplossen.

Wat is style.css en waarom is het belangrijk?

Style.css is een belangrijk bestand binnen een WordPress-thema. In dit bestand staan normaal gesproken de CSS-regels die bepalen hoe je website eruitziet. Denk aan kleuren, lettertypes, afstanden, knoppen, kolommen en andere visuele onderdelen van je website.

Wil je beter begrijpen wat CSS doet en waarom het belangrijk is voor het uiterlijk van je website? Lees dan ook: Wat is CSS en welke toepassingen heeft het in webdesign?

Maar in WordPress heeft style.css nog een tweede belangrijke functie. Bovenaan dit bestand staat namelijk informatie waarmee WordPress het thema herkent. Daarin staat bijvoorbeeld de naam van het thema, de versie, de auteur en soms ook welk parent theme nodig is.

Zonder een goed style.css bestand kan WordPress niet goed bepalen of de map die je uploadt echt een geldig thema is. Daarom verschijnt deze foutmelding meestal wanneer WordPress het bestand niet kan vinden, niet kan lezen of niet als geldig themabestand herkent.

Een simpele style.css header ziet er bijvoorbeeld zo uit:

/*
Theme Name: Mijn Thema
Author: Webmazters
Version: 1.0
Description: Een eenvoudig WordPress thema.
*/

Dit betekent niet dat style.css alleen uit deze regels bestaat. Onder deze header kunnen ook gewone CSS-regels staan. Maar zonder deze herkenbare informatie bovenaan het bestand kan WordPress problemen krijgen bij het installeren of activeren van het thema.

Wanneer verschijnt de foutmelding?

De foutmelding The theme is missing the style.css stylesheet verschijnt meestal tijdens het uploaden van een thema via het WordPress-dashboard. Je gaat dan naar Weergave, Thema’s, Nieuw thema toevoegen en daarna Thema uploaden. Zodra je het zip-bestand kiest en op installeren klikt, controleert WordPress of het bestand een geldig thema bevat.

Als WordPress geen style.css bestand op de juiste plek vindt, stopt de installatie en verschijnt de foutmelding. Dat betekent niet meteen dat je website beschadigd is. Je huidige website blijft meestal gewoon werken. Alleen het nieuwe thema wordt niet geïnstalleerd.

Deze fout komt vooral voor bij premium thema’s die je downloadt van een marktplaats of leverancier. Vaak krijg je dan één groot pakket met documentatie, licenties, demo’s, plugins en het echte thema. Als je dat hele pakket uploadt, kan WordPress het thema niet herkennen. WordPress verwacht namelijk alleen het juiste thema zip-bestand, niet de hele downloadmap met alles erin.

Waar moet style.css staan?

Het bestand style.css moet direct in de hoofdmap van het thema staan. Dat betekent dat je het bestand meteen moet zien zodra je de themamap opent.

Een goede structuur ziet er bijvoorbeeld zo uit:

mijn-thema
style.css
index.php
functions.php
screenshot.png

Een verkeerde structuur ziet er vaak zo uit:

theme-package
documentation
license
demo-content
mijn-thema
style.css
index.php

In dit voorbeeld staat style.css wel ergens in het pakket, maar niet direct op de plek waar WordPress het verwacht. Als je de map theme-package uploadt, kijkt WordPress in die hoofdmap. Daar staat geen style.css, dus verschijnt de foutmelding.

Daarom moet je altijd controleren welke map echt het thema bevat. Die map moet je opnieuw inpakken als zip-bestand en daarna uploaden in WordPress.

Wil je meer weten over belangrijke WordPress-bestanden en hoe ze binnen je thema werken? Dan helpt dit artikel je verder: Wat is functions.php? Uitleg over dit WordPress bestand.

Veelvoorkomende oorzaken van de foutmelding

De melding The theme is missing the style.css stylesheet kan verschillende oorzaken hebben. Meestal gaat het om een verkeerd bestand, een verkeerde mapstructuur of een thema dat niet geschikt is voor WordPress. Hieronder leggen we de belangrijkste oorzaken rustig uit, zonder meteen te doen alsof iedereen dagelijks zip-bestanden uitpakt voor zijn plezier.

1. Verwarring tussen thema en plugin

Een veelgemaakte fout is dat iemand een plugin probeert te installeren als thema, of andersom. WordPress-thema’s en WordPress-plugins zijn niet hetzelfde. Ze hebben een andere structuur en worden op een andere plek geïnstalleerd.

Een thema bepaalt vooral de vormgeving en opbouw van je website. Een plugin voegt extra functies toe, zoals een formulier, SEO-instellingen, beveiliging of caching. Als je juist problemen hebt met het installeren van een plugin, vind je in dit artikel de meest voorkomende oorzaken en oplossingen: Wat te doen als je geen WordPress plugin installeren kunt.

Een thema installeer je via: Dashboard > Weergave > Thema’s > Nieuw thema toevoegen

Een plugin installeer je via: Dashboard > Plugins > Nieuwe plugin toevoegen

Als je een plugin uploadt bij Thema’s, kan WordPress geen style.css vinden. Dan verschijnt dus de foutmelding. Controleer daarom altijd of het bestand dat je uploadt echt een WordPress-thema is.

2. Het bestand is geen WordPress-thema

Niet elk designbestand is automatisch een WordPress-thema. Soms download je een HTML-template, een UI-kit, een ontwerpbestand of een gewone CSS-template. Zo’n bestand kan er mooi uitzien, maar WordPress kan het niet als thema installeren.

Een geldig WordPress-thema bevat meestal bestanden zoals style.css, index.php, functions.php en vaak ook mappen zoals template-parts, assets of inc. Als deze structuur helemaal ontbreekt, heb je waarschijnlijk geen WordPress-thema gedownload.

Dit gebeurt bijvoorbeeld wanneer iemand op een website een “template” koopt, maar niet goed kijkt of het echt om een WordPress theme gaat. Dat woord template wordt helaas overal voor gebruikt, alsof verwarring een producteigenschap is.

Controleer daarom altijd de productinformatie van de leverancier. Er moet duidelijk staan dat het thema geschikt is voor WordPress.

3. Het thema is niet gecomprimeerd als .zip

WordPress kan thema’s via het dashboard alleen uploaden als zip-bestand. Je kunt dus niet zomaar een gewone map uploaden. Ook bestanden zoals .rar, .tar of .7z werken meestal niet via de standaard WordPress-upload.

Als je een themamap op je computer hebt, moet je die eerst comprimeren naar een zip-bestand. Op Windows klik je met de rechtermuisknop op de map en kies je voor Comprimeren naar zip-bestand of Verzenden naar, Gecomprimeerde map. Op Mac klik je met de rechtermuisknop op de map en kies je Comprimeer.

Daarna upload je het nieuwe zip-bestand via WordPress. Let erop dat je de juiste themamap inpakt, niet de volledige downloadmap met documentatie en extra bestanden.

4. Zip-bestand met wachtwoord

WordPress kan geen zip-bestanden installeren die beveiligd zijn met een wachtwoord. Als het zip-bestand eerst een wachtwoord nodig heeft om uitgepakt te worden, kan WordPress de inhoud niet lezen.

De oplossing is simpel. Pak het bestand eerst zelf uit op je computer met het wachtwoord dat je van de leverancier hebt gekregen. Zoek daarna de echte themamap op. Die map pak je opnieuw in als normaal zip-bestand zonder wachtwoord.

Upload daarna dat nieuwe zip-bestand via WordPress. Als de inhoud klopt en style.css op de juiste plek staat, zou de installatie moeten werken.

5. Te veel extra bestanden in de zip

Bij premium thema’s krijg je vaak meer dan alleen het thema. In de download zitten bijvoorbeeld handleidingen, licentiebestanden, demo-content, Photoshop-bestanden, extra plugins en soms meerdere versies van hetzelfde thema.

Als je die volledige download uploadt naar WordPress, weet WordPress niet waar het echte thema staat. Het systeem kijkt in de hoofdmap van het zip-bestand en vindt daar geen style.css. Daardoor krijg je de foutmelding.

Pak het zip-bestand daarom eerst uit op je computer. Zoek daarna naar een map of zip-bestand met een naam die lijkt op de naam van het thema. Open die map en controleer of style.css direct zichtbaar is. Is dat zo, dan heb je waarschijnlijk het juiste bestand gevonden.

Daarna kun je die themamap opnieuw als zip-bestand comprimeren en uploaden.

6. style.css ontbreekt in de hoofdmap

Soms ontbreekt style.css echt in de hoofdmap van het thema. Dan kan WordPress het thema niet herkennen. Dit kan gebeuren door een verkeerde download, een beschadigd pakket of een verkeerd opgebouwde themamap.

Je kunt dit controleren op je computer voordat je het thema uploadt. Pak het zip-bestand uit en open de themamap. Zie je style.css meteen in die map staan? Dan is dat onderdeel in orde. Moet je eerst meerdere mappen openen voordat je style.css ziet? Dan zit het bestand waarschijnlijk te diep in de structuur.

Als het bestand helemaal ontbreekt, download het thema opnieuw van de officiële bron. Gebruik liever geen thema’s van onbekende websites, want die kunnen onvolledig, verouderd of onveilig zijn.

7. Verkeerde uploadlocatie via FTP

Sommige gebruikers installeren een thema niet via het WordPress-dashboard, maar via FTP of via de bestandsbeheerder van de hosting. Dat kan prima, maar dan moet de map wel op de juiste plek terechtkomen.

De themamap hoort in deze map te staan: public_html/wp-content/themes

Bij sommige hostingpakketten heet public_html anders, bijvoorbeeld httpdocs, www of de naam van je domein. Het idee blijft hetzelfde: je zoekt de hoofdmap van de website en gaat daarna naar wp-content en vervolgens themes.

De juiste structuur is dus ongeveer: wp-content/themes/naam-van-je-thema/style.css

Als je de themamap per ongeluk uploadt naar wp-content, uploads of plugins, kan WordPress het thema niet vinden. Verplaats de map dan naar wp-content/themes en controleer daarna in het WordPress-dashboard of het thema zichtbaar is bij Weergave, Thema’s.

8. Beschadigd of onvolledig zip-bestand

Een zip-bestand kan beschadigd raken tijdens het downloaden of overzetten. Soms wordt een download onderbroken door een slechte internetverbinding. Soms gaat er iets mis tijdens het uploaden naar WordPress. Daardoor kunnen bestanden ontbreken, waaronder style.css.

Als je vermoedt dat het bestand niet compleet is, download het thema opnieuw. Doe dat altijd via de officiële website van de ontwikkelaar, je account bij de leverancier of de marktplaats waar je het thema hebt gekocht.

Verwijder daarna het oude zip-bestand van je computer, zodat je niet per ongeluk weer dezelfde kapotte versie uploadt. Ja, dit gebeurt vaker dan je zou willen. Mensen bewaren vier versies van hetzelfde zip-bestand en kiezen dan precies de verkeerde. Technologie houdt van kleine drama’s.

“Een kleine fout bij upload of download kan grote problemen geven, maar met de juiste stappen zet je alles snel weer op de juiste plek en werkt je website weer zoals het hoort.”
Bron: Websiteadviesbureau

9. Fout in bestandsrechten

Bestandsrechten bepalen wie een bestand op de server mag lezen, schrijven of uitvoeren. Als de rechten verkeerd staan, kan WordPress style.css misschien niet lezen. Daardoor kan het lijken alsof het bestand ontbreekt, terwijl het eigenlijk wel aanwezig is.

Voor bestanden in WordPress wordt vaak 644 gebruikt. Voor mappen wordt vaak 755 gebruikt. In de meeste normale situaties hoef je hier niets aan te veranderen, maar bij serverproblemen of handmatige uploads via FTP kan het soms misgaan.

Je kunt de rechten controleren via je hostingpaneel of via een FTP-programma zoals FileZilla. Ga naar de themamap, klik met de rechtermuisknop op style.css en controleer de bestandsrechten. Als het bestand bijvoorbeeld helemaal niet leesbaar is, pas je dit aan naar 644.

Doe dit wel voorzichtig. Zet niet zomaar alles op 777, want dat is onveilig. Het lijkt misschien een snelle oplossing, maar je zet daarmee de deur veel te ver open.

Wil je meer weten over bestands- en mappermissies in WordPress en hoe je die stap voor stap kunt aanpassen? Lees dan ons uitgebreide artikel: Bestands- en mappermissies in WordPress.

10. Subthema (Child Theme) zonder parent-thema

Een child theme is een thema dat afhankelijk is van een parent theme. Het child theme gebruikt de basis van het hoofdthema en bevat alleen aanpassingen. Dat is handig wanneer je wijzigingen wilt doen zonder het originele thema direct aan te passen.

Maar een child theme werkt alleen als het bijbehorende parent theme ook geïnstalleerd is. Als dat hoofdthema ontbreekt, kan WordPress het child theme niet goed koppelen.

In de style.css van een child theme staat meestal een regel zoals deze: Template: naam-van-parent-theme

Die naam moet precies overeenkomen met de mapnaam van het parent theme. Als de naam verkeerd is geschreven of het parent theme ontbreekt, krijg je een fout of werkt het child theme niet goed.

Installeer daarom altijd eerst het parent theme. Daarna installeer en activeer je pas het child theme. Wil je precies weten wat een child theme is en hoe het werkt? Lees dan ons artikel: Wat is een WordPress child theme?.

11. Fout in de header van style.css

WordPress gebruikt de header bovenaan style.css om het thema te herkennen. Als die informatie ontbreekt of verkeerd is geschreven, kan WordPress het thema niet goed tonen bij Weergave, Thema’s.

Een style.css bestand moet bovenaan minimaal een Theme Name bevatten. Andere gegevens zoals Author, Version en Description zijn ook gebruikelijk.

Een goede basis ziet er bijvoorbeeld zo uit:

/*
Theme Name: Mijn Thema
Author: Webmazters
Version: 1.0
Description: Een eenvoudig WordPress thema.
*/

Bij een child theme moet daar vaak ook Template bij staan:

/*
Theme Name: Mijn Child Theme
Template: parent-theme-mapnaam
Author: Webmazters
Version: 1.0
*/

Let goed op spelfouten. Vooral bij de Template-regel van een child theme moet de mapnaam exact kloppen. Eén verkeerde letter kan genoeg zijn om problemen te veroorzaken. Natuurlijk, want computers zijn heerlijk vergevingsgezind, zoals een belastingformulier met stroom.

Hoe controleer je vooraf of je het juiste thema uploadt?

Voordat je een thema uploadt, kun je veel problemen voorkomen door het zip-bestand eerst even te controleren. Dat kost maar een paar minuten en bespaart vaak een hoop frustratie.

Pak het bestand uit op je computer en open de map. Zoek naar het echte thema. Je herkent die map meestal doordat style.css direct zichtbaar is zodra je de map opent. Vaak zie je daar ook bestanden zoals index.php, functions.php en screenshot.png.

Zie je eerst mappen zoals documentation, demo-data, licensing of plugins? Dan zit je waarschijnlijk nog in het algemene downloadpakket en niet in de echte themamap.

Een handige controle is deze vraag: als ik deze map open, zie ik dan meteen style.css? Als het antwoord nee is, upload je waarschijnlijk niet de juiste map.

Hoe installeer je het thema opnieuw via WordPress?

Als je weet welk zip-bestand het juiste thema bevat, kun je het opnieuw installeren via WordPress.

Ga in je WordPress-dashboard naar Weergave en klik op Thema’s. Kies daarna Nieuw thema toevoegen en klik op Thema uploaden. Selecteer het juiste zip-bestand en klik op Nu installeren.

Als de installatie goed gaat, kun je het thema daarna activeren. Krijg je opnieuw dezelfde foutmelding, dan is het verstandig om het zip-bestand opnieuw uit te pakken en de structuur nogmaals te controleren.

Bij premium thema’s staat in je account bij de leverancier vaak een aparte knop zoals Download installable WordPress file only. Dat is meestal het bestand dat je nodig hebt. Het algemene pakket met documentatie is vaak niet geschikt om direct te uploaden.

Hoe los je het probleem op via hosting of FTP?

Als uploaden via het dashboard niet werkt, kun je het thema ook handmatig plaatsen via je hostingpaneel of FTP. De stappen zijn bij de meeste hostingpanelen ongeveer hetzelfde. Alleen de namen van mappen of knoppen kunnen iets verschillen.

Pak eerst het juiste thema zip-bestand uit op je computer. Daarna log je in op je hostingpaneel of open je FileZilla. Ga naar de hoofdmap van je website en open daarna: wp-content/themes

Krijg je tijdens het werken met FTP of je hosting toegangsfouten? Dan helpt dit artikel je om het probleem verder te controleren: Foutmelding FTP-gegevens in WordPress verhelpen.

Upload de volledige themamap naar deze locatie. Controleer daarna of style.css direct in die themamap staat. Het pad moet dus ongeveer zo zijn: wp-content/themes/mijn-thema/style.css

Log daarna in op WordPress en ga naar Weergave, Thema’s. Als alles goed staat, zie je het thema daar verschijnen. Je kunt het dan activeren.

Wanneer moet je contact opnemen met de leverancier?

Soms kun je alles goed doen en blijft het probleem toch bestaan. Dan kan het zijn dat het themapakket zelf niet goed is opgebouwd of dat er bestanden ontbreken in de download.

Neem contact op met de leverancier als:

• style.css echt ontbreekt in het originele themapakket
• de download beschadigd lijkt
• de documentatie niet duidelijk aangeeft welk bestand je moet uploaden
• het thema volgens de leverancier geschikt is voor WordPress, maar WordPress het niet herkent
• je een child theme hebt gekregen zonder duidelijk parent theme

Stuur eventueel een screenshot van de foutmelding en leg uit welk bestand je probeert te uploaden. Dat helpt de ontwikkelaar of supportafdeling om sneller te zien waar het misgaat.

Conclusie

De foutmelding The theme is missing the style.css stylesheet klinkt vervelend, maar is meestal goed op te lossen. In veel gevallen upload je niet het echte themabestand, maar een groter pakket met documentatie, licenties of extra bestanden. WordPress kan dan geen style.css vinden in de hoofdmap en stopt de installatie.

Controleer daarom altijd eerst of je het juiste zip-bestand hebt. Pak het bestand uit, open de themamap en kijk of style.css direct zichtbaar is. Controleer ook of je geen plugin uploadt als thema, of het thema geschikt is voor WordPress en of een child theme het juiste parent theme heeft.

Als je via FTP of je hosting werkt, zorg dan dat de themamap in wp-content/themes staat. Controleer daarna de bestandsrechten en download het thema opnieuw als het pakket beschadigd lijkt.

Met deze stappen kun je de fout meestal zelf oplossen en het WordPress-thema alsnog installeren zonder onnodig gedoe.

Veelgestelde vragen

1. Wat betekent de foutmelding The theme is missing the style.css stylesheet?

Deze foutmelding betekent dat WordPress het bestand style.css niet kan vinden of niet goed kan herkennen in de hoofdmap van het thema.

2. Wat zijn de meest voorkomende oorzaken?

Meestal upload je het verkeerde zip-bestand, bijvoorbeeld een volledig downloadpakket in plaats van het echte thema. Het kan ook gaan om een plugin, een niet-WordPress template, een beschadigd bestand of een ontbrekende style.css.

3. Wat moet ik doen als het bestand ontbreekt?

Download het thema opnieuw via de officiële bron. Controleer daarna of style.css direct in de themamap staat. Als het bestand nog steeds ontbreekt, neem dan contact op met de leverancier van het thema.

4. Kan de fout ook in het thema zelf zitten?

Ja, dat kan. Soms is het themapakket verkeerd opgebouwd of onvolledig. Dit gebeurt vooral bij slechte of onbetrouwbare downloads. Gebruik daarom altijd de officiële download van de ontwikkelaar of leverancier.

5. Hoe weet ik zeker dat ik het goede bestand upload?

Pak de download eerst uit op je computer. Zoek de map waarin style.css, index.php en functions.php direct zichtbaar zijn. Die map moet je opnieuw als zip-bestand inpakken en uploaden via WordPress.

6. Kan ik deze fout oplossen zonder FTP?

Ja, meestal wel. In veel gevallen hoef je alleen het juiste zip-bestand te uploaden via Weergave, Thema’s, Nieuw thema toevoegen. FTP is vooral handig als uploaden via het dashboard niet werkt.

7. Waarom werkt mijn child theme niet?

Een child theme werkt alleen als het parent theme ook geïnstalleerd is. Controleer of het hoofdthema aanwezig is en of de Template-regel in style.css exact overeenkomt met de mapnaam van het parent theme.