Skip to main content

Insight · UX, Navigation & Forms

Formulating Error Messages Directly at the Problem and in an Understandable Way

A good error message appears next to the affected field, names the problem, and explains the solution. Color alone should not convey the error.

"Formulating Error Messages Directly and Clearly" is considered here from the perspective of "Form Scope, Input, and Error Help." For UX teams and web developers, the "Specific Root Cause" and "User Error Code" are particularly important.

Published: · 4 min read · Author:

How do you formulate and place error messages directly at the problem?

An error message specifies the field or process, the specific cause, and an executable correction in understandable language. The message is visibly and programmatically linked to the problem, remains until resolved, and is supplemented by a focusable overview in the case of multiple errors.

Executable Correction

Control signal

Signal 1

Percentage of triggered errors whose visible and programmatic message fully includes the field, cause, and executable correction.

Control signal

Signal 2

Time and number of additional attempts required to successfully correct frequently occurring input or process errors.

User error code

  • User error code Internal validation or server codes appear without translation and do not provide a clear solution.

  • Red without text Color or border highlights the field but does not indicate the cause or the error message necessary for assistive technology.

  • Disappearing message The message disappears after the focus changes, even though the value remains invalid and the task has not yet been corrected.

Specific cause of the error

Test criterion

Specific cause of the error

The message names the affected field or process and clearly explains which condition is not met.

Test criterion

Direct spatial assignment

Text appears at the problematic element, remains programmatically linked to it, and is summarized in case of multiple errors.

  • Executable Correction – Valid format, missing information, or next attempt are described in such a way that the user can continue working without confusion.

Practical scenario: "Error code for user"

After submission, a date field displays only a red border and the code INVALID_DATE. The message "Enter start date in the format day, month, year" is displayed directly next to the field and also appears in the error overview; it remains visible until a valid value is entered.

Direct spatial assignment

  1. Validation and process errors are translated into a concrete cause, the affected value, and a possible correction from the perspective of the task. ```

  2. Link the message directly to the element and add a focusable summary for multiple errors.

  3. Correct a form with multiple simultaneous errors using keyboard and screen readers and check persistence until resolution.

What to check before and after "Formulating error messages directly and clearly".

A relevant follow-up question answered Prioritizing a UX Error List by User and Business Impact"How to Prioritize a UX Error List by User and Business Impact?"

A second link for "Formulating error messages directly and clearly" leads to Building PHP forms so that errors remain traceable rather than invisible. This article remains focused on the question, "How can a PHP form display errors clearly while simultaneously providing enough data for diagnosis?"

If you want to practically implement "Formulating error messages directly and clearly," you can refer to Robust Website Systems . This article focuses on "Form scope, input, and error handling" and "Specific cause of errors."

Conclusion: Formulating error messages directly and clearly

Error messages are instructions for corrective action, not technical status labels. Proximity, a clear cause, and long-term retrievability form a cohesive whole.

Sources and Further Information

The following sources document the technical and methodological guidelines used for "formulating error messages directly and clearly."

Key Thesis

The message uses specific language, is technically linked to the field, and remains accessible until corrected. A summary is also helpful when multiple errors occur.

What This Is Not About

Technical codes, generic messages like "Invalid," or red borders without a specified cause and concrete correction options are insufficient.

What it's about

This refers to visible and programmatically assigned messages that identify the field or process, the cause, and an executable correction step.

More insights

UX, navigation & forms

Determining Form Length Based on Information Value Instead of General Shortness

"Formulating error messages directly and clearly" includes, as a separate test step, the question: How do you determine the correct form length based on the information value?

UX, navigation & forms

Use required fields only where they are truly necessary

"Formulating error messages directly and clearly" is supplemented by a separate decision: Which form fields must actually be completed?

Insights Overview

All VELUNO Insights at a Glance

Further analyses on Website Systems, digital visibility, and robust working models.

Practical Implications

Executable Correction: Starting Point for Implementation

The most frequent validation cases should be tested with actual invalid input. The observed queries will reveal a consistent pattern for field messages, summaries, and focus paths.