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: Sebastian Geier
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
Validation and process errors are translated into a concrete cause, the affected value, and a possible correction from the perspective of the task. ```
Link the message directly to the element and add a focusable summary for multiple errors.
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."
Labeling Controls – W3C Web Accessibility InitiativeOfficial guidance on visible, programmatically linked labels and various labeling patterns.
Error message – GOV.UK Design SystemOfficial guidance on specific, consistent, field-related error messages and their measurement.
Forms Tutorial — W3C Web Accessibility InitiativeThe current WAI tutorial combines short, purpose-built forms with clear labels, instructions, validation, feedback, and logically structured multi-step processes.
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.
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.