Writing Error Messages That Let People Recover

A form that says something went wrong leaves users guessing whether their message was sent or their input was lost. The useful decision is the one that improves a real task for a real user. Identify the constraint before choosing a tool, metric or redesign.

Why this deserves attention

MDN Web Docs offers a practical reference for web behaviour, performance and accessibility. A small team can use that foundation to test a claim in its own product rather than adopting a tool because it is fashionable. The practical question is whether the change improves reliability, access, privacy or maintenance. A good error states what happened in plain language, preserves what can be preserved and offers a next action. The relevant measure is the effect on the product and its users, not the novelty of the implementation.

A practical way forward

Check validation near the relevant field, keep completed values on failure and explain whether retrying could create a duplicate. Set a baseline with one representative task, make a small change and repeat the same check. Share both the result and any trade-off the team observed.

Picture it in a real situation

When a file is too large, show the accepted size and keep the rest of the form intact instead of resetting everything. The value of the example lies in making the result observable. If it fails, examine one assumption at a time before replacing the whole workflow.

What to avoid

Avoid exposing internal stack traces or vague codes to visitors when a concise instruction would solve the problem. Test the claim against the version and workload you actually run. A screenshot or benchmark from another product is a clue, not evidence that your users will benefit.

Takeaway

Pick one measurable improvement, test it with a representative user path and document the trade-off.

Sources and further reading: MDN Web Docs.