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
What are the most popular cannabis products?
Thesaurus.com - The world's favorite online thesaurus!
Scheelzien, volwassenen - Alrijne Ziekenhuis
P2P4U Net Soccer
سریال رویای شیرین جوانی قسمت 338
10000 Divided By 5
Riegler & Partner Holding GmbH auf LinkedIn: Wie schätzen Sie die Entwicklung der Wohnraumschaffung und Bauwirtschaft…
What Was D-Day Weegy
Bubbles Hair Salon Woodbridge Va
State Of Illinois Comptroller Salary Database
Infinite Campus Parent Portal Hall County
Edgar And Herschel Trivia Questions
Find your energy supplier
Nexus Crossword Puzzle Solver
Es.cvs.com/Otchs/Devoted
Knaben Pirate Download
Bros Movie Wiki
Mlb Ballpark Pal
Seattle Rpz
Napa Autocare Locator
Webcentral Cuny
Velocity. The Revolutionary Way to Measure in Scrum
Unity - Manual: Scene view navigation
Jang Urdu Today
VERHUURD: Barentszstraat 12 in 'S-Gravenhage 2518 XG: Woonhuis.
Iroquois Amphitheater Louisville Ky Seating Chart
Morristown Daily Record Obituary
Johnnie Walker Double Black Costco
Coomeet Premium Mod Apk For Pc
11 Ways to Sell a Car on Craigslist - wikiHow
Www Va Lottery Com Result
Directions To Nearest T Mobile Store
Netwerk van %naam%, analyse van %nb_relaties% relaties
Mineral Wells Skyward
Beaufort 72 Hour
Delete Verizon Cloud
Diggy Battlefield Of Gods
Missouri State Highway Patrol Will Utilize Acadis to Improve Curriculum and Testing Management
Reading Craigslist Pa
Final Exam Schedule Liberty University
Craigslist Lakeside Az
Heelyqutii
„Wir sind gut positioniert“
Electric Toothbrush Feature Crossword
Windshield Repair & Auto Glass Replacement in Texas| Safelite
Goats For Sale On Craigslist
Oak Hill, Blue Owl Lead Record Finastra Private Credit Loan
Model Center Jasmin
Runescape Death Guard
Diccionario De Los Sueños Misabueso
ESPN's New Standalone Streaming Service Will Be Available Through Disney+ In 2025
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.