De prijslijst staat op de site, de link is aangeklikt, en de bezoeker krijgt een leeg scherm, een foutmelding of een bestand dat zijn computer niet wil openen. Dat een pdf niet werkt op uw website is een klein probleem met grote gevolgen, want het gaat vrijwel altijd om precies het document waar iemand voor kwam: de brochure, de handleiding, het aanmeldformulier.

Er zijn zes oorzaken die dit veroorzaken, en ze zijn goed van elkaar te onderscheiden aan wat de bezoeker precies ziet. Hieronder loopt u ze langs.

Eerst: wat ziet de bezoeker?

De foutmelding vertelt u waar u moet zoeken. Vraag daarom altijd door bij wie het meldt, of test het zelf uitgelogd in een privévenster.

  • Een 404-melding. Het bestand staat niet op het adres waar naar verwezen wordt.
  • Een 403-melding. Het bestand staat er wel, maar er mag niet bij.
  • Een leeg wit scherm. Het bestand komt binnen maar wordt niet weergegeven; meestal een browserinstelling of een beschadigd bestand.
  • Een download die niet opent. Het bestand is onderweg beschadigd of het is helemaal geen pdf.
  • De download start en stopt halverwege. Een serverprobleem bij grote bestanden.
  • Er gebeurt helemaal niets bij het klikken. De link is stuk of een script vangt de klik af.

Verreweg de meest voorkomende. Het bestand is opnieuw geüpload, waardoor WordPress er een nieuwe naam aan gaf met een cijfer erachter, terwijl de link nog naar de oude naam wijst. Of het bestand is uit de mediabibliotheek verwijderd terwijl de link bleef staan.

Test dit door met de rechtermuisknop op de link te klikken, het adres te kopiëren en rechtstreeks in de adresbalk te plakken. Krijgt u een 404, dan weet u genoeg.

De oplossing: upload het bestand opnieuw, kopieer het adres uit de mediabibliotheek en vervang de link. Wilt u dat het adres gelijk blijft bij een nieuwe versie, gebruik dan een plugin die bestanden kan vervangen met behoud van het adres; hoe dat werkt bij afbeeldingen staat in het artikel over het vervangen van een bestand met behoud van de link.

Oorzaak: het bestand mag niet worden opgehaald

Bij een 403 zitten er rechten of regels in de weg. Drie verdachten.

  1. Verkeerde bestandsrechten. Een bestand dat op 600 staat in plaats van 644, is voor de webserver onleesbaar. Dat gebeurt bij handmatige uploads via een verkeerd ingestelde FTP-client.
  2. Een regel in .htaccess. Sommige beveiligingsvoorschriften blokkeren het rechtstreeks opvragen van bestanden in de uploadsmap. Dat is bedoeld tegen misbruik, maar het raakt ook uw brochure.
  3. Een beveiligingsplugin met een strenge stand. Zoek in de instellingen naar iets over hotlinking of over directe toegang tot bestanden.

Twijfelt u of het aan de rechten ligt, kijk dan of een afbeelding uit dezelfde map wel gewoon laadt. Werkt die wel, dan gaat het om een regel die specifiek op pdf-bestanden slaat.

Oorzaak: de upload is niet goed gegaan

Een pdf die halverwege is aangekomen, opent nergens. Dit gebeurt bij grote bestanden die tegen de uploadlimiet aanlopen: de upload lijkt te slagen, maar het bestand is incompleet.

Controleer de bestandsgrootte in de mediabibliotheek en vergelijk die met het bestand op uw computer. Scheelt dat, dan is de upload mislukt. Verhoog dan de maximale uploadgrootte of splits het document.

Loopt u vaker tegen mislukte uploads aan, dan is er meer aan de hand met de instellingen van uw server; wat daar speelt, leest u in de uitleg over mislukte uploads.

Praktische ondergrens: een pdf boven de 10 MB is voor een bezoeker op mobiel internet sowieso onprettig. Comprimeer het document of splits het op in delen. Een brochure van 40 MB is technisch mogelijk, maar niemand wacht daarop.

Oorzaak: het is geen echte pdf

Soms is het bestand een Word-document of een afbeelding waarvan de extensie is veranderd naar .pdf. De browser probeert het als pdf te openen, faalt, en toont een leeg scherm.

Open het bestand op uw eigen computer voordat u het uploadt en controleer of het werkelijk een pdf is. Bij twijfel exporteert u het opnieuw vanuit het oorspronkelijke programma.

Een variant hiervan: pdf-bestanden met een wachtwoord of met beveiliging tegen kopiëren. Die openen in sommige browsers niet inline maar alleen na downloaden. Dat is geen fout, maar het verwart bezoekers wel.

Oorzaak: er zit een cachelaag tussen

Heeft u het bestand vervangen door een nieuwe versie maar krijgt de bezoeker nog de oude prijslijst, dan wordt er een bewaarde kopie geserveerd. Dat speelt zowel bij een cacheplugin als bij een netwerkdienst als Cloudflare.

Leeg in dat geval de cache voor dat specifieke adres. Werkt dat niet, geef het nieuwe bestand dan een iets andere naam en pas de link aan; dan is er geen twijfel mogelijk.

Dit is ook de reden dat een prijslijst soms bij de ene klant wel en bij de andere niet klopt: hun browsers hebben het bestand op verschillende momenten opgehaald.

Wat u eromheen kunt regelen

Twee dingen maken pdf-bestanden op een zakelijke site een stuk minder foutgevoelig.

Ten eerste: zet bij elke belangrijke download de datum en de versie in de bestandsnaam, bijvoorbeeld prijslijst-2026-01. Dan is meteen duidelijk of iemand naar de juiste versie kijkt, en u voorkomt dat een oude kopie in omloop blijft.

Ten tweede: controleer of uw belangrijkste documenten ook echt vindbaar zijn. Een pdf kan in Google terechtkomen en dat is meestal prima, maar niet als het om een interne prijslijst of een klantendocument gaat. Wilt u dat niet, zet zulke bestanden dan achter een inlog in plaats van te vertrouwen op een moeilijk te raden adres. Ieder die het adres kent, kan het bestand openen.

Een installatiebedrijf ontdekte na een klacht dat hun offertes al twee jaar in een openbare map stonden, keurig genummerd en voor iedereen op te vragen. De pdf werkte prima; dat was juist het probleem. Sinds die tijd staan die documenten achter een klantenlogin.

Uw controle voor deze week

Loop de downloads op uw site één keer per kwartaal na. Klik elk document aan in een privévenster, controleer of het opent en of het de juiste versie is. Bij de meeste bedrijven zijn dat vijf tot tien bestanden en kost het een kwartier.

Blijft een bestand weigeren terwijl alles lijkt te kloppen, dan zit er meestal een regel op serverniveau die u van buitenaf niet ziet. Voor het uitzoeken van bestanden die niet willen openen is een blik in de serverlogboeken doorgaans genoeg; bij WebMaintor pakken we dat samen met de hostingpartij op.

Begin met de eenvoudigste test: open uw belangrijkste download in een privévenster op uw telefoon. Werkt dat, dan werkt het voor vrijwel al uw bezoekers.