Beispiele für Fehlermeldungen: schlecht, gut und großartig, neu geschrieben
Acht Fehlermeldungen, vom rohen Code zu einem Text, mit dem Menschen etwas anfangen können. Jede Stufe erklärt, die Dreizeilen-Formel hinter den großartigen und eine Checkliste für dein nächstes Review.
Eine großartige Fehlermeldung sagt Menschen drei Dinge: was passiert ist, warum es passiert ist und was sie als Nächstes tun sollen, samt Button, der genau das erledigt. Die meisten Produkte hören beim Ersten auf, und viele kommen nie über einen Code hinaus. Unten findest du acht Fehlermeldungen von schlecht bis großartig, den Grund hinter jeder Stufe und eine Formel für deine nächste Meldung.
Was sich von schlecht zu großartig ändert
Schlecht
Großartig
Die schlechte Meldung ist für den Server geschrieben. Ein 403 ist ein echter Statuscode und korrekt, aber die lesende Person erfährt nichts, was sie nutzen kann. Die großartige Meldung ist für den Menschen geschrieben: Sie nennt die Datei, erklärt, dass sie privat ist, sagt, wer sie öffnen kann, und macht den nächsten Schritt zu einem einzigen Tipp.
Jede Stufe fügt eine Sache hinzu:
| Stufe | Was sie Menschen gibt | Was noch fehlt |
|---|---|---|
| Schlecht | Einen Code oder ein vages Wort wie „fehlgeschlagen" | Was passiert ist, warum, was zu tun ist |
| Gut | Was passiert ist, in einfachen Worten | Warum, und was als Nächstes zu tun ist |
| Großartig | Was passiert ist, warum, und der nächste Schritt auf einem Button | Nichts, was sie entscheiden müssten |
1. Kein Zugriff
Schlecht
Error 403.
Ein Statuscode. Für Entwickler korrekt, für alle anderen leer.Gut
Du hast keinen Zugriff auf diese Datei.
Sagt, was passiert ist, in den Worten der lesenden Person. Lässt sie aber hängen.Großartig
Diese Datei ist privat. Bitte Sam um Zugriff, wir sagen dir Bescheid, sobald du drin bist.
Sagt warum (sie ist privat), wer es lösen kann (Sam) und was danach passiert. Der Button heißt Zugriff anfragen, die Anfrage braucht also nur einen Tipp.
Ein 403 bedeutet, dass die Person angemeldet ist, aber keine Berechtigung hat. Diese Unterscheidung zählt für den Text: Sie muss sich nicht erneut anmelden, sondern jemand muss die Datei teilen.
2. Eine abgelehnte Karte
Schlecht
Transaktion fehlgeschlagen.
„Fehlgeschlagen" ohne Subjekt. Lag es an der Karte, am Shop, an der Verbindung?Gut
Deine Karte wurde abgelehnt.
Nennt die Ursache, mit der Menschen etwas anfangen können.Großartig
Deine Karte wurde abgelehnt. Deine Bank hat abgelehnt. Probiere eine andere Karte oder bitte deine Bank um Freigabe.
Legt das Problem bei der Bank, nicht bei der Person, und zeigt zwei Auswege. Der Button heißt Andere Karte nutzen, der schnellere Weg.
Zahlungsfehler betreffen das meiste Geld und die meiste Peinlichkeit. Gib niemandem die Schuld und halte den Ausweg auf demselben Screen bereit.
3. Eine zu große Datei
Schlecht
Upload-Fehler.
Kann alles Mögliche sein, also versuchen Leute dieselbe Datei erneut und laufen gegen dieselbe Wand.Gut
Diese Datei ist zu groß.
Die Ursache, aber nicht, um wie viel.Großartig
Dieses Video ist 2,4 GB groß. Das Limit liegt bei 2 GB. Kürze es ein wenig und versuche es noch einmal.
Beide Zahlen, damit man sieht, dass die Lücke klein ist. Der Button heißt Video kürzen und löst es, ohne die App zu verlassen.
Wenn ein Limit im Spiel ist, nenne das Limit. Eine Zahl, die man nie erfährt, kann man nicht beheben.
4. Offline gehen
Schlecht
Netzwerkfehler.
Klingt, als sei etwas kaputtgegangen, und vielleicht Arbeit verloren.Gut
Du bist offline.
Klar, aber die erste Sorge in jedem Kopf lautet: „Sind meine Änderungen weg?"Großartig
Du bist offline. Deine Änderungen sind auf diesem Handy gespeichert und werden synchronisiert, sobald du wieder online bist.
Beantwortet die Sorge, bevor sie gestellt wird. Der Button heißt Erneut versuchen.
5. Abgemeldet werden
Schlecht
Error 401: Unauthorized.
„Unauthorized" liest sich wie ein Vorwurf, und es ist schon wieder ein Code.Gut
Deine Sitzung ist abgelaufen.
Korrekt, aber „Sitzung" ist ein Entwicklerwort.Großartig
Du wurdest abgemeldet. Es sind 30 Tage vergangen. Melde dich erneut an, dann bringen wir dich hierher zurück.
Erklärt den Grund und verspricht, dass niemand seinen Platz verliert. Der Button heißt Anmelden.
Ein 401 ist der Gegenfall zum 403: Die Person ist nicht angemeldet, oder ihre Anmeldung ist abgelaufen. Der Weg zum Anmeldescreen ist die Lösung, und die Zusage, danach wieder am selben Ort zu landen, nimmt den Grund zu zögern.
Drei weitere, frisch geschrieben
Dieselben Regeln gelten für Situationen, die die fünf oben nicht abdecken. Diese drei sind unsere eigenen Beispiele.
Schlecht
Error 500. Etwas ist schiefgelaufen.
Der Code bringt nichts, und „etwas" gibt zu, dass wir es nicht wissen.Gut
Wir konnten deine Änderungen nicht speichern.
Übernimmt das Problem und benennt, was scheiterte.Großartig
Wir konnten deine Änderungen nicht speichern. Das liegt an uns, nicht an dir. Dein Text ist noch da, versuche es in einer Minute erneut.
Sagt, wer schuld ist und dass nichts verloren ging. Der Button heißt Erneut speichern.
Schlecht
Too many requests.
Maschinensprache für einen Menschen, der wahrscheinlich schon genervt ist.Gut
Zu viele Versuche. Versuche es später erneut.
Klar, aber „später" kann eine Minute oder ein Tag sein.Großartig
Zu viele Versuche. Zu deiner Sicherheit ist die Anmeldung 15 Minuten pausiert. Du kannst stattdessen jetzt dein Passwort zurücksetzen.
Nennt die Wartezeit, den Grund und einen schnelleren Weg. Der Button heißt Passwort zurücksetzen.
Schlecht
Ungültiger Link.
Legt nahe, die Person habe etwas falsch eingegeben.Gut
Diese Einladung ist abgelaufen.
Die wahre Ursache, ohne Schuldzuweisung.Großartig
Diese Einladung ist abgelaufen. Einladungen gelten 7 Tage. Bitte Maya, dir eine neue zu schicken.
Sagt, warum Links ablaufen und wer es lösen kann. Der Button heißt Neue Einladung anfragen.
Die Formel: was passiert ist, warum, was als Nächstes
Jede großartige Meldung oben passt in dieselben drei Zeilen:
[What happened, in the reader's words.]
[Why, in one short sentence.]
[What to do next.] [Button: the next step as a verb]
| Meldung | Was passiert ist | Warum | Was als Nächstes |
|---|---|---|---|
| Kein Zugriff | Diese Datei ist privat | Nur eingeladene Personen können sie öffnen | Zugriff anfragen |
| Abgelehnte Karte | Deine Karte wurde abgelehnt | Deine Bank hat abgelehnt | Andere Karte nutzen |
| Zu groß | Dieses Video ist 2,4 GB groß | Das Limit liegt bei 2 GB | Video kürzen |
| Offline | Du bist offline | Änderungen sind auf diesem Handy gespeichert | Erneut versuchen |
| Abgemeldet | Du wurdest abgemeldet | Es sind 30 Tage vergangen | Anmelden |
Die „Warum"-Zeile streichen Teams als Erstes, und sie verhindert das nächste Support-Ticket.
Eine Checkliste für dein nächstes Review
- Keine rohen Codes. 403, 401 und 500 gehören in die Logs, nicht in die Meldung.
- Keine Schuldzuweisung. „Deine Bank hat abgelehnt", nicht „Du hast eine ungültige Karte eingegeben".
- Nenne die Zahlen. Ein Größenlimit, eine Wartezeit, eine Anzahl Tage.
- Ein Button, als Verb benannt. „Video kürzen", nicht „OK".
- Sag, was erhalten blieb. Wenn nichts verloren ging, sag es.
- Bestätige bei der Anmeldung keine Konten. „Falsches Passwort" verrät Fremden, dass das Konto existiert. Sag stattdessen „E-Mail und Passwort passen nicht zusammen".
- Prüfe dann die Farbe. Worte tragen den Fehler, Farbe und Icon unterstützen sie. Unser Paper zur Farbe von Fehlermeldungen zeigt die Rottöne für Hell und Dunkel.
Paper
Farbe von Fehlermeldungen: die 8 Rottöne statt #FF0000
Das Schwesterpaper zu diesem: Hier sind die Worte, dort die Farben, Icons und der Code.
FAQ
Wie schreibt man eine gute Fehlermeldung?
Sag in einfachen Worten, was passiert ist, in einem kurzen Satz, warum es passiert ist, und was als Nächstes zu tun ist. Lege den nächsten Schritt auf einen Button, der als Verb benannt ist, etwa Erneut versuchen oder Andere Karte nutzen.
Was sind Beispiele für schlechte Fehlermeldungen?
Rohe Codes und vage Worte: „Error 403", „Error 401: Unauthorized", „Transaktion fehlgeschlagen", „Upload-Fehler" und „Netzwerkfehler". Jede ist korrekt, und keine sagt Menschen, was sie tun sollen.
Sollten Fehlermeldungen Fehlercodes anzeigen?
Nicht als die Meldung selbst. Ein Code hilft Support und Entwicklern, also lass ihn in den Logs oder in kleinem Text unter der eigentlichen Meldung, falls dein Support-Team ihn braucht.
Was ist der Unterschied zwischen einer 401- und einer 403-Fehlermeldung?
Ein 401 bedeutet, dass die Person nicht angemeldet ist oder ihre Anmeldung abgelaufen ist, die Meldung sollte sie also zur Anmeldung schicken. Ein 403 bedeutet, dass sie angemeldet ist, aber keine Berechtigung hat, die Meldung sollte also sagen, wer ihr Zugriff geben kann.
Warum sollte ein Anmeldefehler nicht „falsches Passwort" sagen?
Weil er bestätigt, dass das Konto existiert, was jemandem hilft, Konten zu erraten. Sicherheitsempfehlungen raten zu einer einzigen allgemeinen Meldung bei falscher E-Mail oder falschem Passwort.
Quellen
- HTTP-Statuscodes: 403 Forbidden und 401 Unauthorized bei MDN.
- Error-message guidelines, Nielsen Norman Group.
- Writing, Apple Human Interface Guidelines.
- Authentication and error messages, OWASP Cheat Sheet Series.
- Zuerst als Karussell veröffentlicht auf UX Brainy.
Want every error, empty and loading state written and designed as one system? Our team designs product UI with the words in it from the first draft.
Get Started
