Skip to content
>devspeak
← glossary
level 2Bugs & Debugging

Failure state

also: failure states, error state, error states

What your app shows and does when something goes wrong, like an error message, a retry button, or a blank screen.

a bit more technical

The condition a system or interface enters when an operation fails: what the user sees, what data is kept or lost, and whether recovery is possible. Designed failure states degrade gracefully; undesigned ones crash, hang, or show misleading output.

picture it

A vending machine that runs out of chips. A good one shows "Sold out" and returns your money. A bad one keeps your coins and shows nothing.

why it matters

Agents usually build the happy path, where everything works. Asking about failure states makes them decide what users see when the network drops or a payment fails.

what your agent might say
agent
I've added failure states to the upload screen: a clear message if the file is too large, a retry option if the network drops, and the draft is kept either way.
how you might use it
you → your agent
For the booking form, list every failure state: payment declined, slot taken, network down. For each, tell me what the user sees and whether their input is kept.
common mistake

Thinking an error message alone counts as handling failure. A good failure state also keeps the user's work and gives them a way forward.

builds on