Skip to Content
Patternfly Logo

Error messages

An error message is a message indicating something went wrong. A user typically sees an error message when they attempt to perform an action but cannot continue because something isn’t right.

Don’t blame users. A user should never feel like the error is their fault. Avoid language like “You did something wrong.”

Before
After
You entered the wrong password.The password is incorrect.

Give users a next step: A user should never feel stuck. If they’re hit with an error, give them the information they need to continue with their task.

Before
After
Your list already has the maximum number of items. You are not able to continue customizing.Your list has the maximum number of items. To continue customizing, remove one item.

Avoid jargon: Error messages are frustrating enough without technical terms that users might not understand. Avoid jargon and use terms that are familiar to your users.

Before
After
Error code 5959: Outdated version information. Task termination pending.Your task is outdated. To keep it active, update its version.

Include the right amount of description: Tell your user what is wrong. An error without an explanation can add to their frustration and prevent them from finding a solution.

Before
After
An error occurred. The email cannot be sent.To send this email, turn on your email permissions in user settings.

However, don’t include too much information. The user doesn’t need to know exactly what is going on behind the scenes. Only give them information about what went wrong and what they can do next.

Before
After
Your information cannot be saved. Our system is currently designed to accommodate 1 record per user. The system memory is unable to store more at this time.Only 1 record can be saved. To continue, remove one of your records.