← All ideas

Essay · 3 min · Arturo Ordóñez

What an interface needs to explain

Every button, form and error message makes a small promise. Reviewing those promises reveals problems that a screenshot cannot show.

Sand-coloured concrete planes and geometric shadows.

On arriving at a website, people try to work out whether they are in the right place. They look for what is offered, who it is for and how to proceed. A layout can answer those questions or postpone them. A headline takes up space even when it says very little, and a photograph can attract attention without helping someone understand the service.

Trust then depends on actions doing what their labels suggest. This calls for reviewing a journey: reading, choosing, acting and finding out what happened. Inspecting the opening screen alone leaves much of that experience unchecked.

An action label sets an expectation

“Check availability” and “Book” make different promises. The first suggests an informative response; the second suggests that a date will be reserved. Before adjusting a button’s size, establish what it actually does. Its wording should anticipate that result and any intermediate step that could affect the decision.

Each field in a form also needs an understandable purpose. A name, email address and description of the request may be enough to begin a conversation. Every additional field deserves questions: is it needed now, what format does it accept, and what happens if the person does not have that information?

The W3C guidance on labels and instructions explains that inputs need to indicate what information is expected. This is a specific check; meeting it alone does not establish the accessibility of the whole form.

Status should match what happened

An interface can report that a request is being sent, that a provider accepted it or that the outcome is unknown. These states need separating before a confirmation is written. “Request accepted” does not establish that the recipient has read an email.

People who cannot see a visual update also need the relevant information. The W3C documentation on status messages describes how assistive technology can announce changes without moving focus. The interface still needs to choose which changes deserve an announcement and avoid unnecessary interruptions.

This review extends to the control itself. While a submission is pending, pressing the button again should not create another request. When the operation finishes, the response needs to make any remaining action understandable.

An error needs a way forward

“Something went wrong” leaves all the investigation to the person reading it. A useful explanation identifies what is known: a field is incomplete, the connection was lost or the provider could not accept the request. When the cause is unknown, the message should describe that uncertainty rather than blame the visitor.

Recovery can be examined through three questions:

  • Is the information already entered still available?
  • Is the field that needs attention identified?
  • Is retrying safe, or should the status of the original operation be checked first?

Keeping a draft means deciding where it is stored and when it is removed. Adding a retry button means understanding whether the first operation could already have produced an effect. These behaviour decisions eventually affect the wording and the layout.

Review beyond the screenshot

A screenshot helps compare sizes, contrast and placement. Reviewing the journey requires opening the menu, using the keyboard, enlarging text, changing language and reaching the main action on a narrow screen. It is also worth checking what remains available when an image or video fails to load.

Images can establish a mood; diagrams can explain relationships. Their presence should leave the information needed to act available. With a video that starts on request, its poster and written context should help someone decide whether to play it.

The outcome should be a list of changes that can be checked: rename an action, retain an entry, correct a status message or move an explanation closer to its control. The same journey can then be repeated to see what has improved.

A reading hierarchy
What you offer
Who it is for and what it includes
How to contact you

Size and space give each question a different weight.

Read, act and recover30 s · Silent film
Read the visual story

An interface should guide reading, make a pending action visible and preserve a way forward when something fails.

An entry point for reading. Purpose helps people recognise what they can do here. The path starts at Purpose, continues through Information and reaches Action. A marker shows the reading position.

A pending action has a state. While waiting, the same request should not be sent again. Action leads to Pending. The repeat path is stopped while a response is unavailable.

Confirmation states what is known. Accepting a request does not confirm that a person has read it. The response is labelled Request accepted. Reading by a person is shown as a fact not yet confirmed.

A failure needs an explanation. The message should identify what happened and what can be corrected. The path branches to Error. A connection identifies information needing attention instead of discarding everything entered.

Recovering the work helps people continue. Keeping the input and allowing another attempt reduces repetition. Preserved input connects to Correct and Try again. An arrow returns to the action point.