Skip to main content

Handle errors inside modal dialogs

Learn how the in-dialog error banner helps users understand what went wrong and what to do next when an action in a modal fails.

Audience

This guide is designed for project manager.

Steps​

Step 1: See an error message in the dialog​

When an action inside a modal fails, an error banner appears at the bottom of the dialog, clearly stating in plain English what went wrong instead of showing a technical error.

See an error message in the dialog

Step 2: Review additional error details​

If more information is available from the system, a secondary line appears under the main message, giving extra context to help users understand the reason for the problem.

Review additional error details

Step 3: Follow the suggested next step​

When a recovery option is available, a clear call to action is displayed in the banner, such as a button, link, or guidance text, so users know exactly how to resolve or work around the issue.

Follow the suggested next step

Step 4: Notice non-error blocking messages​

For situations where the dialog is blocked for non-fault reasons, such as access or document rules, the banner switches to a softer notice style so users can see that nothing is broken but an action is still required.

Notice non-error blocking messages

Step 5: Support for screen reader and keyboard users​

As soon as the banner appears, focus moves to it so screen reader and keyboard users immediately hear or see the error message and are placed next to the recovery action.

Support for screen reader and keyboard users

Last updated: 2026-08-31