UX Collective

We believe designers are thinkers as much as they are makers. https://linktr.ee/uxc

Follow publication

How to design for troubleshooting when the user workflow isn’t clear

How do you design when there’s no set path users follow?

Kai Wong
UX Collective
Published in
6 min readFeb 11, 2025

A man looking inside the car hood with a flashlight trying to diagnose what’s happening.
Photo by Andrea Piacquadio: https://www.pexels.com/photo/man-in-black-jacket-and-black-knit-cap-inspecting-car-engine-3807277/

“If only it was always this easy.” My manager said after listening to a presentation solving a simple problem.

In domains like B2B/SaaS or Healthcare UX, you don’t tackle straightforward problems. In many cases, you’re unsure what the user does to solve the problem since every case differs.

Whether troubleshooting a network or finding the proper treatment among hundreds of options, it can be tricky to understand how to help users troubleshoot.

To understand why, let’s consider a common troubleshooting scenario around alerts.

Alerts or user problems at scale

At first, designing alerts seems pretty straightforward. All you need to do is create a layout showing as much information as possible to clarify what the user should do next.

Except, that’s not what the real challenges are. That might be okay if you only design a single alert for a page.

But there are two significant problems with alerts that are often contradictory:

  • Alerts need to be immediately understood at a glance
  • Alerts, at scale, need to be easily prioritized (or triaged) quickly

The first point is easily explained by looking at a car (or airplane) dashboard. If there’s an alert you need to pay attention to, the user can’t spend five seconds deciphering it while driving 60 miles an hour: that would result in a crash.

So many alerts often use universal signals (like a triangle with an exclamation point) and specific colors designed to stand out to the users and make them notice it.

Unfortunately, that doesn’t work at scale. If you have 100 alerts designed with eye-catching colors and symbols, you will have users suffering from “alert fatigue.”

A woman looking up in shock as dozens of alert messages, about all of her documents, appear to be popping up at once
Eye-catching alerts can feel like this

This is when users stop paying attention to alerts or don’t know what to do. Imagine you’re a…

Create an account to read the full story.

The author made this story available to Medium members only.
If you’re new to Medium, create a new account to read this story on us.

Or, continue in mobile web

Already have an account? Sign in

Written by Kai Wong

7xTop writer in UX Design. UX, Data Viz, and Data. Author of Data-Informed UX Design: https://tinyurl.com/2p83hkav. Substack: https://dataanddesign.substack.com

Responses (1)

Write a response

One thing that feels missing is how to handle user frustration when they still can't find a clear solution. Do you think adding guided troubleshooting steps or AI-powered suggestions could help?

--