The tone of your error messages can have a significant effect on how your users interpret them.
Be positive
Instead of telling the user what they did wrong, tell the user how to get it right.
Not recommended
You didn’t enter a name.
Recommended
Enter a name.
Not recommended
You entered an invalid postal code.
Recommended
Enter a valid postal code. [Explanation of valid postal code.]
Not recommended
ANSI C++ forbids declaration ‘ostream’ with no type ‘ostream’.
Recommended
ANSI C++ requires a type for declaration ‘ostream’ with type ‘ostream’.
Don’t be overly apologetic
While maintaining positivity, avoid the words “sorry” or “please.” Focus instead on clearly describing the problem and solution.
Note: Different cultures interpret apologies differently. Some cultures expect apologies in certain situations; other cultures find apologies from software corporations somewhat insincere. Although this lesson suggests avoiding apologies, be aware of your target audience’s expectations.
Not recommended
We’re sorry, a server error occurred and we’re temporarily unable to load your spreadsheet. We apologize for the inconvenience. Please wait a while and try again.
Recommended
Google Docs is temporarily unable to open your spreadsheet. In the meantime, try right-clicking the spreadsheet in the doc list to download it.
Avoid humor
Don’t attempt to make error messages humorous. Humor in error messages can fail for the following reasons:
- Errors frustrate users. Angry users are generally not receptive to humor.
- Users can misinterpret humor. (Jokes don’t always cross borders well.)
- Humor can detract from the goal of the error message.
Not recommended
Is the server running? Better go catch it :D.
Recommended
The server is temporarily unavailable. Try again in a few minutes.
Don’t blame the user
If possible, focus the error message on what went wrong rather than assigning blame.
Not recommended
You specified a printer that’s offline.
Recommended
The specified printer is offline.
Multiple choice exercise
Which of the following error messages do not use the appropriate tone?
- Sorry, you are not allowed to leave feedback.
- You entered an invalid title for your item.
- 404 Error. Oops, that is embarrassing.
1
3
2
1, 2, and 3.