How to Write an Effective Error Message | Built In (2024)

Mistakes happen. When people use a product, they’re bound to get stuck somewhere in response to their actions.

Those situations can be frustrating for users if they aren’t handled properly within the product. It depends on the experience that the product is providing to its users. That’s where error messages come in.

Error Message Tips to Know

  1. Be clear.
  2. Be short and meaningful.
  3. Don’t use technical jargon.
  4. Don’t blame the user.
  5. Avoid negative words.
  6. Give directions to the user.
  7. Be specific and relevant.
  8. Avoid uppercase text.
  9. Provide appropriate actions.
  10. Use the progressive disclosure approach.
  11. Use proper placement.

An effective error message needs to communicate to the user the nature of the problem in simple words along with a solution to rectify it. Include too much information or too little, and you’ll end up frustrating the user and potentially losing them.

Below are a few tips to strike the right balance and create an effective error message.

11 Error Message Tips to Know

1. Be Clear

Write error messages in clear and simple language. The user should be able to understand the problem while reading an error message.

If the error message is ambiguous, and the user is not able to find the reason for the message, then it’s pointless. Users can’t do anything to fix the problem, and it badly impacts the experience of the product.

How to Write an Effective Error Message | Built In (1)

Examples

How to Write an Effective Error Message | Built In (2)
How to Write an Effective Error Message | Built In (3)

More on DesignHow to Center a Div Horizontally and Vertically in CSS

2. Be Short And Meaningful

An error message should only contain necessary information. Most of the time, the user isn’t willing to read a long story.

Be concise and write a short description that is meaningful for the user and gives him a clear idea of the problem and how to resolve it.

Avoid using redundant words and don’t over-communicate the problem.

How to Write an Effective Error Message | Built In (4)

Examples

How to Write an Effective Error Message | Built In (5)
How to Write an Effective Error Message | Built In (6)

3. Don’t Use Technical Jargon

Most users aren’t interested in the technical details behind the problem. If a message contains technical terms or jargon, it will only confuse the user.

Try to use simple and plain language without referring to implementation details.

If it’s important to mention technical and complex details, then place them in a troubleshooting section and direct the user so that he can resolve the issue quickly.

How to Write an Effective Error Message | Built In (7)

Examples

How to Write an Effective Error Message | Built In (8)
How to Write an Effective Error Message | Built In (9)

4. Don’t Blame the User

A good error message is humble. It conveys the issues gracefully to its user without blaming him for his actions.

Users can perform an incorrect action again and again. But it’s the responsibility of design to inform them about mistakes in a good way.

How to Write an Effective Error Message | Built In (10)

Examples

How to Write an Effective Error Message | Built In (11)
How to Write an Effective Error Message | Built In (12)

5. Avoid Negative Words

There are certain negative words that should be avoided. Since error messages are based on some unusual user actions, there’s a chance that the message could feel disrespectful to the user.

How to Write an Effective Error Message | Built In (13)

Examples

How to Write an Effective Error Message | Built In (14)

6. Give Direction to User

A good error message has three parts: problem identification, details about the cause for the error (if helpful) and a solution (if possible).

Whenever an error occurs, the user wants to fix it as soon as possible. The error message should have enough information to guide users on how to fix the situation.

The message can also direct the user to some other place or person from where he can get detailed help about the problem.

How to Write an Effective Error Message | Built In (15)

Examples

How to Write an Effective Error Message | Built In (16)

7. Be Specific And Relevant

The message should contain relevant information so that users can relate to specified locations and options easily.

Point out the exact location of the problem, where users should go and what steps they need to follow to resolve it.

If an error message contains vague information, the user will get confused, and it becomes difficult for him to remove the error.

How to Write an Effective Error Message | Built In (17)

Examples

How to Write an Effective Error Message | Built In (18)
How to Write an Effective Error Message | Built In (19)

8. Avoid Uppercase Text

Text in all caps is difficult to read, and it can feel like you’re shouting at the user.

The error message is a place where the user is informed about a critical scenario, so using upper-case text can feel discouraging.

Example

How to Write an Effective Error Message | Built In (20)

9. Provide Appropriate Actions

Actions are an important part of the error message. Appropriate actions provide guidance to users about the next step.

Actions are possible routes to solve the problem. A message can contain one or more actions for the user. If the user has to perform specific actions to remove the error, then use the same action name as the button title.

How to Write an Effective Error Message | Built In (21)

Examples

How to Write an Effective Error Message | Built In (22)

10. Use the Progressive Disclosure Approach

If there is detailed information related to a message that the user may not want to see, then place it in a show/hide section. It can be useful for an advanced user that may want to know about technical details.

Just make sure to place the least important information in these sections, as most of the time, users won’t go to the show/hide section.

How to Write an Effective Error Message | Built In (23)

Examples

How to Write an Effective Error Message | Built In (24)

More on DesignWhat Is a Splash Screen?

11. Use Proper Placement

It’s very important to place an error message closer to the area where the error occurred. Users shouldn’t have to hunt for the mistake after reading the message.

For example, when the user is filling in information in a form, it’s best to provide validation error along with the controls it relates to.

Otherwise, the user will first find the erroneous control and then resolve it.

An error message should be visible and noticeable. A message appearing on a screen should be responsive, following the user even as they scroll.

How to Write an Effective Error Message | Built In (25)

It’s best to avoid errors completely, but since we live in a world of humans, that’s not possible.

However, by following standard rules and guidelines, any errors can be handled in a helping way instead of scolding the user for his mistakes.

How to Write an Effective Error Message | Built In (2024)
Top Articles
Avoid Overspending By Following The Rule Of Half | Mad Money Monster
Beyond Bitcoin: A guide to the new digital currencies
Basic Setup – OpenXR & Pimax HMDs...
Active Inmates Ashland County
The Fat Soluble Vitamins Are Weegy
Geheimtipp Anna Maria Island- die schönsten Strände Floridas | Reiseblog und Fotografieblog aus Österreich
Honey Huxxlee Leaks
Number One Buffet Ravenna
City Of Dreams Hosts The Biggest Movie Premiere In American History - Haute Living
Ky Smartgov
Free Atm For Emerald Card Near Me
De beste uitvaartdiensten die goede rituele diensten aanbieden voor de laatste rituelen
Skip The Games Maui
A Killer Paradox: how to watch, plot, cast and everything we know
MSGR. JOSEPH PETERSON, V.G.
Possiamo ancora definire Tyler, The Creator "un rapper”?
Pg Huntington Beach Tournament 2023
Domino's On West Florissant
Chrome Hearts Schmuck und Uhren – 15 im Angebot bei 1stDibs
O'reilly's In Mathis Texas
Boostmaster Lin Yupoo
Teenlilyrose08
World's Most Expensive Tiles | Buy Premium & Luxurious Tiles at Ramirro Ceramica
Brazos County Mugshots Busted Newspaper
Tom Wages Stone Mountain
Classy Spa Fort Walton Beach
Where To Buy Patti Labelle Sweet Potato Pie - PieProNation.com
The Year The Internet Stopped Laughing
Whisk Recipe Calculator
Find A Red Cross Blood Drive
Hillside Funeral Home Washington Nc Obituaries
Bekijk ons gevarieerde aanbod occasions in Oss.
Bustadice Review (2024) | Bonus Codes | Strategy | Scripts
The Front Porch Self Service
Panola County Busted Newspaper
Paytexaswarrant
Avgolemono Greek Lemon Chicken Soup
Juicy Deal D-Art
Obituary for GARY ALAN YOUNGS | After®
Quantum Break's Story and Ending Explained
Ocps 2023-24 Calendar
Sunny Nails Whitehouse
Craigslist Murfreesboro Pets
Gen 50 Kjv
Miniature Australian Shepherd Craigslist
Go Nutrients Intestinal Edge Reviews
How to Sell Cars on Craigslist: A Guide for Car Dealers | ACV Auctions
Dutchess Cleaners Boardman Ohio
South Bend Tribune Online
Iwindsurf Forums
Latest Posts
Article information

Author: Dean Jakubowski Ret

Last Updated:

Views: 6176

Rating: 5 / 5 (70 voted)

Reviews: 85% of readers found this page helpful

Author information

Name: Dean Jakubowski Ret

Birthday: 1996-05-10

Address: Apt. 425 4346 Santiago Islands, Shariside, AK 38830-1874

Phone: +96313309894162

Job: Legacy Sales Designer

Hobby: Baseball, Wood carving, Candle making, Jigsaw puzzles, Lacemaking, Parkour, Drawing

Introduction: My name is Dean Jakubowski Ret, I am a enthusiastic, friendly, homely, handsome, zealous, brainy, elegant person who loves writing and wants to share my knowledge and understanding with you.