Brandon Dorn Brandon Dorn is a Senior Product Designer at Viget, where he focuses on prototyping, design systems, and information architecture.

Using Figma variants for better error handling design

5 min read 1529

Figma Logo Over Painted Background

Product designers are invariably optimists. They’re bringing something new into the world, whether an entire platform or just a feature, which requires a determined focus on ideal usage scenarios so that key aspects of a product perform as well as possible.

This optimism keeps them — and their teams — motivated when they encounter the inevitable challenges that arise in product work. Yet it can also prevent designers from accounting for all of the ways in which a product can fail its users: interactions that don’t fire, content that doesn’t load, mistakes a user might make, or even simply accounting for all possible empty states, an often overlooked aspect of UI design.

Empty States
Thoughtful empty state examples from Empty States.

While developers inherit a history of robust error-testing practices, there isn’t much of an analogue in design. Designers often critique their work mainly for design issues (e.g., “this color combination doesn’t pass accessibility”) without digging into potential implementation issues (e.g., “what happens if this table doesn’t load?”). Designers are biased toward best-case scenarios, whereas developers instinctively consider all the ways something could go wrong, then test for it.

Yet products earn trust and retain users by the ways in which they gracefully fail. A product is only as good as its most error-prone interaction (insert quote about how failure reveals character).

As important as the perceived quality of a product is, error handling design and copy are often an afterthought, written on the spot when a developer identifies a potential erroneous scenario in an interface. This isn’t a knock on developers — they’re the ones doing the needed work of anticipating feature failures — but rather a recognition that designers may not take the initiative to make thoughtful, thorough, and consistent error messages across entire interfaces. I’m including myself here, too.

Error Messages
Some choice error messages from Instructional Design.

There are a few reasons why designers may neglect error handling UI. For one, designers often aren’t aware of the potential error states of their designs, so they need to have intentional conversation with their developers.

Second, design tools haven’t historically been friendly to state management. Designing error states meant duplicating artboards in order to document all possible permutations, resulting in unwieldy files with arcane naming systems.

With the advent of improved component design features, designing numerous states for the same element or screen has become quicker and easier. Each issue concerns communication: designers and developers identifying and documenting error states together, and designers making and sharing error handling UI in a more manageable way. Below, I’ll describe some ways to handle both.

Documenting error states

Not all error states can be anticipated at the start, of course. Yet it’s helpful to document types of error states for components before designing them, updating designs as additional error states are discovered.

Generally speaking, there are two types of errors:

We made a custom demo for .
No really. Click here to check it out.

  1. Product-side errors occur when the error originates in the product. Something doesn’t load, a button doesn’t work, the server can’t be reached. Some product-side errors are universal and predictable; others are specific to certain platforms. Designers rely on developers to share these potential scenarios
  2. User-side errors occur when a user makes a mistake. As pointed out in Nielsen’s fifth usability heuristic, users might make a “slip” or an outright mistake: “Slips are unconscious errors caused by inattention. Mistakes are conscious errors based on a mismatch between the user’s mental model and the design.” Of course, if user-side errors can be avoided in the first place, the product should be changed accordingly

Auditing and designing for all possible states ensures that design consideration permeates the nooks and crannies of product interfaces, that no opportunity for thoughtful microcopy or loading animations or affirming illustrations is overlooked. It’s up to designers to consistently seek developers’ input on all of the product-side errors that can occur in the product they are designing.

As for user-side errors, usability testing prototypes is a necessary practice for discovering actual and potential issues. Keeping a database of user research observations in a tool like Airtable provides designers not only with general and feature-specific areas for improvement, but can also reveal needed states for pages and components. Small improvements can go a long way toward affirming users throughout their use of the product. Maybe that information-dense dashboard needs a skeleton screen after all.

Using Figma variants

For the past five years, Figma has incrementally established itself as a leading tool for designing for the web. They’ve developed a feature set that has the clear, implicit strategy of facilitating collaboration between designers and developers. While many of Figma’s features (e.g., styles and components) aren’t unique to the tool, recent additions like smart animate, auto layout, and variants are a leap forward for designers working on robust, interaction-rich products.

Variants allow designers to define multiple properties for a single component, which simplifies page design and brings the work of design closer to the work of development. For example, a single button can contain variations for size, state, icon placement, split (whether the button contains a flyout menu), etc. A standard button component might contain properties for:

Type Primary, Secondary, Tertiary
State Default, Hover, Active, Focus, Disabled
Size Large, Medium, Small
Icon Left, Right, None
Split On, Off

Prior to variants, designers dealt with unwieldy collections of components, one for each state. Now, once defined, these properties can be adjusted on the fly for the component. To learn how to set component properties, check out the Figma tutorial.

Button Variants

Combined with auto-layout, variants can be used to create more versatile components, like a secondary navigation that can alternate primary and secondary actions depending on the context.

Navigation Component

Even with variants, designers still have to design each and every state. However, states can now be contained within components, much the same way developers define properties for UI elements. And oftentimes, designers can simply adjust certain properties of a component to define a new variant for it. Designing error states becomes that much easier.

Figma Variants In practice

Say a team is working on a dynamic, multi-field form set that updates as a user fills it in. Multiple states can be defined for individual form elements (default, focus, loading, disabled, error, etc.):

Form Component
Various states for a form element defined as variants.

But we can take this a step further and define properties for the form set. The set component might contain a loading state, default state, various states for different types of form interactions, error states for individual forms, and an error state for the set overall.

Variants also enable conditional logic to be displayed more easily, as conditions can be defined as properties. Taken together, these features streamline the creation of clickable prototypes in Figma, useful for both usability testing and more clearly conveying design intent.

Form Prototype
An example of variants at work in a form component. This prototype was made using a single form component made up of instances of a single select component, each with their own variants.

The definition of variants can appear unwieldy, with sometimes 40+ permutations defined for a single button component. Yet, once defined, accessing component states prototypes is far less onerous than it once was (and still is, in other tools), and variants are easily added and modified at the source. You can explore this example here. This is a relatively basic example, but hopefully it’s evident how variants can be used to design states for more complex components.

The state of digital state design

The evolution of digital design tools can be seen as the effort to clarify the conversation between design and development. Ten years ago, websites were designed in Photoshop, as designers pushed the limits of the photo editing tool to create images that looked like websites.

Today, with design tools like Webflow, Figma, and Adobe XD, the boundary between design and development is fading, and to good effect. Modern design and prototyping tools have turned what used to be an error-prone telephone game on project teams (“turn this PSD file into a responsive webpage!”) into a face-to-face conversation, everyone speaking the same language and picking up on important nuances.

Yet, the handoff between design and development will never be perfectly seamless, and better tooling won’t change product designers’ process of its own accord. To learn to look at a product with developers’ eyes, designers need to work closely and often with developers.

But we’re reaching a point with modern design tools where the work of design is able to parallel the work of development such that designers can support the myriad permutations of a product UI without the cumbersome file management once required.

It’s not difficult to imagine a future where static design prototypes resemble their functional counterparts even more closely; nuanced state transitions have always been a limiting element. Call me overly optimistic, but it feels like we’re entering a golden age for design tools.

: Full visibility into your web apps

LogRocket is a frontend application monitoring solution that lets you replay problems as if they happened in your own browser. Instead of guessing why errors happen, or asking users for screenshots and log dumps, LogRocket lets you replay the session to quickly understand what went wrong. It works perfectly with any app, regardless of framework, and has plugins to log additional context from Redux, Vuex, and @ngrx/store.

In addition to logging Redux actions and state, LogRocket records console logs, JavaScript errors, stacktraces, network requests/responses with headers + bodies, browser metadata, and custom logs. It also instruments the DOM to record the HTML and CSS on the page, recreating pixel-perfect videos of even the most complex single-page apps.

Brandon Dorn Brandon Dorn is a Senior Product Designer at Viget, where he focuses on prototyping, design systems, and information architecture.

Leave a Reply