Skip to content

Errors and Warnings

Follow these rules to create good error messages.

Acknowledge

Do not write: do not write Replace with: replace with
Error The system is not responding. Refresh your page to try again.

Apologize

Do not write: do not write Replace with: replace with
System error We're sorry. The system is currently unavailable.

Explain

Do not write: do not write Replace with: 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: do not write Replace with: replace with
Login failed The password you entered is not correct. Please try again.

Provide the right amount of detail

Do not write: do not write Replace with: replace with
Sorry The server is currently unavailable. Please try again later.

Avoid jargon and developer speak

Do not write: do not write Replace with: 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: do not write Replace with: 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: do not write Replace with: 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: do not write Replace with: 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: do not write Replace with: replace with
You didn't enter a name. Please enter your name.

Add humour but only when appropriate

Do not write: do not write Replace with: 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.