Goed opgestelde foutmeldingen helpen gebruikers te begrijpen wat er misging en hoe ze dit kunnen oplossen — waardoor frustratie en supportverzoeken worden verminderd. Deze gids stelt normen voor het schrijven van duidelijke, consistente en empathische foutmeldingen in de gebruikersinterface.
Kernprincipes
| Principe | Wat het betekent |
|---|---|
| Helderheid | Gebruik eenvoudige, alledaagse taal. Vermijd jargon en vage beschrijvingen. |
| Uitvoerbaarheid | Vertel de gebruiker precies wat hij daarna moet doen. Als er geen actie nodig is, zeg het dan. |
| Empathie | Geef nooit de gebruiker de schuld. Gebruik ondersteunende, neutrale frasering. |
| Consistentie | Gebruik dezelfde toon, structuur en terminologie in alle berichten (bijvoorbeeld, meng niet "serverfout" en "systeemfout" voor hetzelfde probleem). |
| Beknoptheid | Houd het kort — genoeg context om nuttig te zijn, niet meer. |
| Toegankelijkheid | Volg de WCAG-richtlijnen zodat berichten begrijpelijk zijn voor gebruikers van alle niveaus. |
Anatomie van een foutmelding
Elke foutmelding zou tot drie vragen moeten beantwoorden:
- Wat is er gebeurd? Stel het probleem duidelijk uit.
- Waarom is het gebeurd? (optioneel) Voeg een korte reden toe als het de gebruiker helpt het te begrijpen.
- Wat moet de gebruiker nu doen? Geef een specifieke actie of punt om verder te helpen.
Structuur:
| Component | Voorbeeld |
|---|---|
| Kopstuk | "Verzoek niet kunnen verwerken" |
| Beschrijving | "We zijn een probleem tegengekomen tijdens het verwerken van uw verzoek. Probeer het alsjeblieft opnieuw." |
| Actie/Hulp | "Als het probleem aanhoudt, neem dan contact op met de support van support@document360.com." |
Schrijfrichtlijnen
| Richtlijn | ✅ Doe | ❌ Niet doen |
|---|---|---|
| Gebruik eenvoudige taal | "De bestandsgrootte overschrijdt de toegestane limiet." | "Bestandsupload mislukt vanwege groottebeperkingen." |
| Wees specifiek | "Ongeldig e-mailadres. Voer een geldig formaat in (bijv. name@domain.com)." | "Invoerfout." |
| Bied een oplossing | "De gebruikersnaam is al bezet. Probeer een andere gebruikersnaam." | "Deze gebruikersnaam is niet beschikbaar." |
| Vermijd technisch jargon | "We konden geen verbinding maken met de server. Controleer je internetverbinding en probeer het opnieuw." | "Server 503 fout gedetecteerd." |
| Gebruik beleefde, positieve taal | "Er is iets misgegaan. Probeer het over een paar minuten opnieuw." | "Fout! Probeer het nog eens." |
| Lijn af met de context | "Dat konden we niet redden. Probeer het alsjeblieft opnieuw." | "Save-fout! Actie geblokkeerd!" |
| Gebruik actieve stem | "We konden het gevraagde artikel niet vinden." | "Het gevraagde artikel is niet gevonden." |
| Vermijd negatieve woorden | "We konden uw verzoek niet voltooien." | "Uw verzoek is niet verwerkt." |
Foutcodes: Voeg ze alleen toe bij complexe of technische fouten waar ze helpen bij het oplossen van problemen.
Voorbeeld: "Het verzoek kon niet worden verwerkt (Foutcode: 403). Neem contact op met support voor hulp."
Veelvoorkomende foutscenario's
| Scenario | Foutmelding |
|---|---|
| Ongeldige invoer | "Ongeldig wachtwoord. Het wachtwoord moet minstens 8 tekens zijn en een nummer bevatten." |
| Ontbrekend vereist veld | "E-mailadres vereist. Voer uw e-mailadres in om verder te gaan." |
| Servertimeout | "We hebben problemen met de server. Probeer het later opnieuw." |
| Fout bij het uploaden van bestanden | "Bestandsupload mislukt. Zorg ervoor dat het bestand onder de 5 MB is en in een ondersteund formaat zit." |
| Toegang geweigerd | "Je hebt geen toestemming om deze pagina te bekijken. Neem contact op met je beheerder." |
| Betalingsfout | "Betaling kon niet worden verwerkt. Controleer je kaartgegevens of probeer een andere methode." |
| Dubbele invoer | "Deze categorienaam bestaat al. Kies alsjeblieft een andere naam." |
| Sessie afgelopen | "Je sessie is verlopen. Log alstublieft opnieuw in om verder te gaan." |
Pre-Publicatie Checklist
- Is de boodschap duidelijk en beknopt?
- Verklaart het wat er misging?
- Biedt het een uitvoerbare volgende stap?
- Is het vrij van technisch jargon?
- Is de toon beleefd en professioneel?
- Is het consistent met andere foutmeldingen in het product?
Onderhoud
Bekijk alle foutmeldingen periodiek naarmate de productkenmerken zich ontwikkelen en werk ze snel bij om verouderde of verwarrende richtlijnen te voorkomen.