Errors and Warnings
Follow these rules to create good error messages.
Acknowledge
Do not write:  |
Replace with:  |
Error |
The system is not responding. Refresh your page to try again. |
Apologize
Do not write:  |
Replace with:  |
System error |
We're sorry. The system is currently unavailable. |
Explain
Do not write:  |
Replace with:  |
Your order cannot be processed. |
We cannot process your order. This item is currently out of stock. |
Be specific. What happened?
Do not write:  |
Replace with:  |
Login failed |
The password you entered is not correct. Please try again. |
Provide the right amount of detail
Do not write:  |
Replace with:  |
Sorry |
The server is currently unavailable. Please try again later. |
Avoid jargon and developer speak
Do not write:  |
Replace with:  |
Request error: Password was not validated - min character groups of 3 not fulfilled. |
Your password must contain lower and upper case characters and a special character. |
Be human and friendly
Do not write:  |
Replace with:  |
Image exceeds size requirements |
This image is too big. Select an image that is smaller than 300 x 300 px. |
Be clear and unambiguous
Do not write:  |
Replace with:  |
Your request has not been completed. Discard this request? [Cancel] [Continue] |
You haven't completed your request. Do you want to discard this request? [Discard Request] [Complete Request] |
Be concise. If in doubt, aim for 15–20 words per sentence
Do not write:  |
Replace with:  |
The email address you entered does not match the required format. Please enter your email using the standard format. |
Please enter your email address in the format yourname@example.com. |
Choose the right voice and tone
Do not write:  |
Replace with:  |
You didn't enter a name. |
Please enter your name. |
Add humour but only when appropriate
Do not write:  |
Replace with:  |
OOPS something went wrong ¯\_(ツ)_/¯ |
Your request didn't work. Please contact us so we can fix this issue as soon as possible. |
Learn more
Follow these links to learn more about creating effective error and warning messages.