Foutmeldingen in WordPress zijn vaak verwarrend en lastig op te lossen, maar de “Your Sitemap Appears to Be An HTML Page” fout hoort daar gelukkig niet bij.

Wanneer je dit probleem tegengekomen bent, vraag je je waarschijnlijk af wat deze foutmelding betekent, waarom het erg is dat je sitemap een HTML-bestand is, en hoe je dit probleem kan oplossen. En wat kan je doen als je sitemap al de juiste indeling heeft, maar je deze foutmelding nog steeds te zien krijgt?

We leggen je in dit artikel alles uit: hoe een sitemap werkt, in welke indeling deze hoort te zijn, en verschillende manieren om de foutmelding op te lossen.

Bekijk onze videogids voor het repareren van de fout “Your Sitemap Appears to Be An HTML Page”:

Wat is een sitemap?

Weet je eigenlijk hoe zoekmachines je website kunnen vinden? Het antwoord is: met een handige bot, een webcrawler om precies te zijn, wat een geautomatiseerde tool is die zoekmachines op pad sturen om de pagina’s van je website te indexeren.

Met de miljoenen pagina’s die online te vinden zijn, zou het onmogelijk zijn om informatie over elke website handmatig te verzamelen. Webcrawlers struinen het internet af en slaan informatie op over elke pagina en elk media-item.

Dat klinkt misschien simpel, maar Google weet niet automatisch wanneer jij een nieuwe pagina aan je website toegevoegd hebt, zoals wanneer je een blogartikel publiceert of een nieuw product aan je webshop toevoegt. Daarom sturen ze regelmatig de webcrawler het web op om je website te bezoeken en te bekijken of er iets veranderd is, maar dat proces is niet onmiddellijk klaar.

Wanneer je een grote website hebt, kan zo’n crawler zomaar belangrijke pagina’s missen, zelfs na meerdere bezoeken. Dit is vooral een probleem wanneer er weinig links naar die pagina’s gaan.

En dat is precies het probleem dat sitemaps oplossen. Deze XML bestanden zijn anders dan een normale pagina op je website, ze zijn namelijk nauwelijks leesbaar voor mensen, en zijn ook niet bedoeld voor je bezoekers. Webcrawlers daarentegen kunnen sitemaps heel goed lezen, en gebruiken ze om ervoor te zorgen dat alles geïndexeerd wordt.

Een voorbeeld van een XML sitemap.
Een voorbeeld van een XML sitemap.

Sitemaps bieden simpelweg een lijst met alle pagina’s op je site, inclusief een linkhiërarchie, en een overzicht van andere bestanden op je website, zoals video’s en afbeeldingen. Hierdoor kan Google alles op je website zien, waardoor je SEO verbeterd wordt.

Wanneer je een tool als Google Analytics of Google Search Console gebruikt hebt in het verleden, heb je wellicht de mogelijkheid gezien om te linken naar je sitemap. Google zal dan eerst naar dat bestand kijken, voordat ze webcrawlers naar je website sturen.

De homepage van Google Search Console.
De homepage van Google Search Console.

Verschillen tussen HTML en XML sitemaps

Je sitemap blijkt een HTML-pagina te zijn, maar wat is daar mis mee? En waarom wil Google dat je dat verandert?

Sitemaps moeten op een gestructureerde manier gemaakt worden, zodat webcrawlers ze eenvoudig kunnen begrijpen. In principe moet dit een XML-bestand zijn. Ze kunnen soms ook RSS, Atom, KML of een tekstbestand lezen, maar XML is de standaard.

Een voorbeeld van een RSS feed.
Een voorbeeld van een RSS feed.

XML staat voor “Extensible Markup Language.” Het is een webtaal die sterk op HTML lijkt. Het verschil zit ‘m vooral in de toepassing: XML is wel leesbaar voor mensen, maar de voornaamste functie is om andere machines te helpen om data en documenten te lezen en begrijpen.

In dit geval helpt een XML bestand om de webcrawler te vertellen waar de pagina’s en mediabestanden op je website zijn, en wat de onderlinge verhoudingen zijn.

Maar wellicht ben je de term “sitemap” ook al wel eens in een andere context gezien. Er bestaan namelijk ook HTML sitemaps, maar het grote verschil is dat die wél voor mensen zijn gemaakt, en niet voor webcrawlers.

Als je eens geklikt hebt op een link naar de navigatie van een pagina, waar je dan een eenvoudig leesbare en georganiseerde lijst met pagina’s op de site zag, wordt dit technisch gezien ook een sitemap genoemd. Maar alhoewel het handig kan zijn voor bezoekers, is dat niet wat Google graag wil hebben.

Een XML sitemap ziet er voor de meeste gebruikers uit als een lading onleesbare code, of een enorme lijst met links, dus als je een handige navigatiepagina voor bezoekers wil maken, kan je beter een HTML sitemap maken, naast de XML sitemap.

Een voorbeeld van een sitemap.
Een voorbeeld van een sitemap.

Andere soorten sitemaps

Wanneer je aan een sitemap denkt, heb je waarschijnlijk meteen een beeld voor je van een lijst met pagina’s op een site. Maar Google gebruikt verschillende soorten sitemaps voor verschillende soorten informatie. Denk bijvoorbeeld aan:

  • Video: Video’s op je website kunnen apart geïndexeerd worden voor gebruik in de resultaten van Google Video.
  • Images: Hetzelfde geldt voor afbeeldingen. Sommige afbeeldingen, zoals afbeeldingen die zich binnen JavaScript code bevinden, worden in principe niet geïndexeerd. Een sitemap voor afbeeldingen kan helpen om je website te tonen in de zoekresultaten in Google Images.
  • News: schrijf je een column? Google heeft een speciale pagina met Google News binnen de zoekmachine, en een News sitemap kan ervoor zorgen dat je daar in de zoekresultaten te zien bent, en dus meer verkeer krijgt.
  • Code: Google indexeert stukjes code om programmeurs te helpen bij het zoeken naar code en bestanden.
  • Geographic data: Je kan een speciale KML sitemap gebruiken om Google betere data te geven over de locatie van je bedrijf.

Sommige van bovenstaande typen informatie zitten vaak deels ook al in je normale sitemap. Voor andere soorten heb je een speciale sitemap nodig. Maar ze moeten allemaal in het juiste format zit, meestal in XML of een ander speciaal format, maar niet in HTML.

Zo maak je een XML sitemap

Wanneer je een link naar een HTML sitemap hebt opgestuurd, moet je die vervangen door een XML versie. Weet je niet hoe je een XML sitemap kan maken, dan zijn er verschillende WordPress plugins en generators die je hiervoor online kan vinden.

Wanneer je al een XML sitemap hebt, maar deze niet werkt, kan het helpen om een nieuwe sitemap te maken en op te sturen.

Er zijn twee eenvoudige manieren om een sitemap te maken: je gebruikt een plugin, of je gebruikt een sitemap generator.

Maak een sitemap met een plugin

Bij WordPress is het gebruiken van een plugin de makkelijkste manier om een dynamisch bijgewerkte sitemap van je website te maken. Op die manier hoef je zelf ook geen bestanden naar de server te uploaden.

Er zijn allerlei plugins waarmee je een sitemap kan maken:

  • Yoast SEO: De populairste SEO plugin biedt ook een optie om een sitemap te maken. Je kan dit vinden in de instellingen, onder SEO > General > Features en dan XML Sitemaps.
  • RankMath: Naast een normale sitemap, kan deze SEO plugin ook een speciale WooCommerce sitemap én een KML geodata sitemap maken. Ga hiervoor naar RankMath > Sitemap Settings.
  • XML Sitemaps: Zoals de naam al doet vermoeden, zal de XML Sitemaps plugin een XML sitemap voor je genereren. De plugin is 100% gratis en open source, dus er zijn ook geen verborgen kosten of addertjes onder het gras.
  • XML Sitemap & Google News: Deze plugin maakt zowel een XML sitemap als een Google News sitemap. De plugin is eenvoudig te installeren en in te stellen.
  • Companion Sitemap Generator – HTML & XML: Wanneer je een HTML sitemap én een XML sitemap wil maken, is dit de ideale plugin voor jou. Beide sitemaps worden automatisch bijgewerkt, dus je hoeft zelf niks te doen.

Sitemap Generator websites

In plaats van een plugin kan je ook een sitemap generator gebruiken, zoals XML-Sitemaps of XML Sitemap Generator. Vervolgens upload je het aangemaakte bestand naar je website.

Stap 1: Maak een sitemap via één van de genoemde websites, of een andere generator. Download het XML document.

XML-Sitemap Generator
XML-Sitemap Generator

Stap 2: Download FileZilla of (indien mogelijk) gebruik je webhost om verbinding te maken met je website via FTP.

Stap 3: Plaats het XML bestand in de root map van je website. De root is de bovenste locatie van je website, dus de map waar je in start wanneer je voor het eerst verbinding maakt.

Zo los je de sitemap fout op

De sitemap fout wordt meestal veroorzaakt doordat iemand per ongeluk een HTML pagina opstuurt in plaats van een XML bestand. Maar wanneer je wel een XML sitemap uploadt, maar dit als HTML pagina wordt gezien, heb je mogelijk een iets ingewikkelder probleem.

Maar maak je nog geen zorgen: het probleem is meestal een eenvoudig te verhelpen conflict tussen je WordPress plugins. Enkele tips om je sitemap goed te laten werken:

Controleer op errors en redirects

Het is makkelijker om een probleem op te lossen als je een specifieke errorcode hebt waar je op kan zoeken. Het eerste dat je daarom moet doen is het bekijken van de pagina met je sitemap, en kijken of je daar rare foutcodes ziet.

Kinsta’s 404 errorpagina.
Kinsta’s 404 errorpagina.

Wanneer je een fout ziet als je de sitemap opent, dan zou Google hierdoor kunnen denken dat het een HTML pagina bekijkt. Gebruik deze fout in je zoektocht naar een oplossing. Onze lijst met HTTP statuscodes kan ook helpen.

En wat als je af en toe een sitemap fout ziet, dus soms wel en soms niet? Dat kan voorkomen wanneer je dynamisch een sitemap aan laat maken.

Kleine serverfouten en timeouts zullen ervoor zorgen dat Google je sitemap opeens als HTML pagina ziet, wanneer er een foutmelding getoond wordt in plaats van een XML bestand. Zolang de fout niet heel vaak voorkomt, is het meestal niet zo’n probleem.

Iets anders om goed op te letten zijn redirects. Wanneer je de sitemap pagina probeert te bezoeken, maar uitkomt op je homepage of in een eindeloze redirect loop, zal dat ook een probleem opleveren.

Wanneer je fouten of redirects te zien krijgt die niet weg gaan, komt dit meestal door een conflict tussen plugins. Plugins die sitemaps aanmaken, zoals Yoast, kunnen een conflict veroorzaken, of een caching plugin veroorzaakt het probleem.

Ook schijnbaar irrelevante plugins kunnen problemen veroorzaken. Gebruik de Health Check & Troubleshooting plugin om de oorzaak te achterhalen.

De Health Check & Troubleshooting plugin na het installeren.
De Health Check & Troubleshooting plugin na het installeren.

Installeer de plugin als je deze nog niet hebt, en ga vervolgens naar Tools > Site Health > Troubleshooting Mode. Hiermee worden alle plugins tijdelijk uitgezet, zonder dat dit problemen oplevert voor je bezoekers.

Kijk nu of de error of redirect inderdaad verdwenen is. Zo ja, zet de plugins dan één voor één weer aan, tot het probleem weer verschijnt. Zoek naar conflicten tussen plugins.

Je kan vervolgens contact opnemen met de auteur(s) van de plugin om de bug te rapporteren, en hen om hulp te vragen.

Schakel caching uit

Eén van de oorzaken die we het vaakst zien zijn caching plugins. Wanneer een sitemap gecachet wordt, kan dit soms problemen veroorzaken, waarbij Google het als een HTML pagina leest, omdat je XML bestanden namelijk niet zo moet cachen.

De meeste caching plugins zullen een pagina met sitemap daarom niet caching, maar het kan toch gebeuren dat de pagina wel gecachet wordt, vooral wanneer je een unieke URL voor je sitemap aanmaakt.

Gelukkig hoef je dan niet meteen de hele cachingplugin uit te zetten. Je kan gewoon een uitzondering toevoegen, en dan zou het probleem automatisch opgelost moeten zijn.

De documentatie van je plugin zal dit precies uitleggen, maar zo doe je het in WP Super Cache en W3 Total Cache:

Voor WP Super Cache, ga je naar Settings > WP Super Cache. Onder het tabblad Advanced scroll je naar Add here strings (not a filename) that forces a page not to be cached.

In dit deel kan je aan het eind van de URL van je sitemap toevoegen. Wanneer je sitemap zich bijvoorbeeld op “example-site.com/sitemap.xml,” bevindt, voer je “/sitemap.xml” in.

Voor W3 Total Cache, navigeer je naar Performance > Page Cache, en zoek je Advanced > Never cache the following pages. Net als bij WP Super Cache voer je de sitemap URL in.

Voeg dit ook toe aan Minify, via Performance > Minify en Never minify the following pages, aangezien dit soms ook problemen veroorzaakt.

Controleer de URL van je sitemap

Alhoewel dit misschien een nogal simpele tip is, is het altijd de moeite van het controleren waard: heb je wel de goede link opgestuurd? Het is een makkelijke fout om te maken, en zelfs één verkeerd teken stuurt de zoekmachines naar de verkeerde plek.

Controleer de link die je hebt ingestuurd, zowel in Google als in een SEO of sitemap plugin.

Sommige plugins voegen bijvoorbeeld een eind-slash toe aan het einde van de pagina (dus “example-site.com/sitemap/” in plaats van “example-site.com/sitemap”). Dit ene teken kan een hoop gedoe opleveren, vooral wanneer hierdoor een redirect loop ontstaat.

Ook nu kan je weer de troubleshooting modus in de Health Check plugin gebruiken om te achterhalen welke plugin de boosdoener is. Meestal kan je het terugleiden naar één individuele plugin.

Verwijder overtollige sitemaps

Alhoewel het meestal geen problemen veroorzaakt als je maar naar de goede pagina linkt, kan het hebben van overtollige sitemaps ook jezelf in verwarring brengen. Daarnaast is je server nu ook onnodig bezig met het updaten van sitemaps die je niet eens gebruikt.

Plugins kunnen ook verschillende sitemaps aanmaken, en wellicht weet je niet dat WordPress er ook zelf één voor je maakt. Je zou al deze sitemaps dus moeten controleren en verwijderen, behalve de sitemap die je wil gaan gebruiken. Hier zijn enkele URL’s die je kan controleren op sitemaps:

  • /sitemap.xml — Een veelgebruikte URL voor sitemaps, die de meeste sitemap plugins gebruiken.
  • /wp-sitemap.xml — Dit is het adres voor de standaard sitemap die WordPress voor je maak sinds versie 5.5.
  • /sitemap_index.xml — Dit is de URL voor de sitemap die Yoast aanmaakt.

Wanneer je een andere SEO of sitemap plugin gebruikt, kunnen die ook nog een heel andere URL gebruiken. Controleer de relevante documentatie en zorg dat je ongewenste sitemap functies uitzet.

Heb je echt een sitemap nodig?

Soms kunnen sitemaps voor steeds nieuwe problemen zorgen. En dan is een eenvoudige oplossing niet genoeg om de problemen te laten ophouden. Wanneer je steeds lastige problemen tegenkomt, kan je je gaan afvragen hoe belangrijk een sitemap nou echt is.

Het wordt je in het algemeen sterk aangeraden om een sitemap te maken, en Google zelf geeft ook aan nooit je SEO te zullen verminderen wanneer je dit doet. Het kan je SEO dus alleen maar verbeteren, en ervoor zorgen dat je site sneller geïndexeerd wordt.

Maar het is niet vereist om een sitemap te hebben in elke situatie, en Google geeft ook aan dat sommige websites ze ook niet gebruiken.

Stel dat je website minder dan 500 pagina’s heeft, en je ook niet verwacht daar ooit boven te komen. In dat geval, zolang je alle interne links goed op orde hebt (wat sowieso verstandig is), en je ook niet heel veel mediabestanden hebt die je graag in Google Images of Google Video wil hebben, heb je niet per se een sitemap nodig.

Aan de andere kant verbetert een sitemap je SEO altijd, en aangezien er verder geen nadelen aan zitten, is het altijd het slimst om problemen met je sitemap toch op te lossen. Je website is nu misschien nog klein, maar dat blijft misschien niet zo.

Zit je echt vast met je sitemap, dan kan je altijd contact opnemen met de ondersteuning van je host om te vragen of zij de oorzaak kunnen zien.

Samenvatting

De “sitemap appears to be an HTML page” fout kan lastig terug te leiden zijn, maar ontstaat meestal door een verkeerd geformatteerde pagina of een conflict met je plugins, dat eenvoudig op te lossen is. Zodra je de oorzaak van het probleem hebt gevonden, is de oplossing ook nabij.

Door de ene fout ontdek je soms echter ook een ander, dus als je nog fouten op je website hebt, kijk dan eens bij ons grote artikel met meer dan 65 WordPress fouten, inclusief oplossingen.

Salman Ravoof

Salman Ravoof is een autodidactische webdeveloper, schrijver, creator en een groot bewonderaar van Free and Open Source Software (FOSS). Naast techniek is hij enthousiast over wetenschap, filosofie, fotografie, kunst, katten en eten. Lees meer over hem op zijn website en kom in contact met Salman op X.