Dialog

Prompts users to take or complete an action.

  • To break users out of their flow to complete an action.
  • To present simple choices or small bits of information.
  • You have more complex or structured information—use a modal.
  • To keep current screen in focus or not block content on wide screens—use a popover.
  • For temporary messages without actions—use a toast.
FigmaReactiOSAndroidDocumentation
Released
Released
n/a
n/a
Released

Illustration: optionally adds visual context; title: sets the context and works best when short; description: adds more context and works best when short; primary action: sets the main action for the user to complete; secondary action: optionally sets another action to perform, usually cancelling/closing the Dialog.

Dialogs are disruptive to the main flow. Only start one after the user has taken an action so it’s clear why it was triggered.

Users want to feel in control of their actions. Since dialogs interrupt the main user flow, they can invoke negative feelings in users. Make sure users feel in control by offering them a clear option to cancel the dialog and get back to the main flow.

There are situations that all users need to complete before continuing (like accepting terms for an additional service), but it should still be possible to go back to the previous point in the flow.

A dialog with two buttons: agree and cancel.

Do

Give a cancel option.

A dialog with only one option: agree. There is no way to close/cancel the dialog.

Don't

Don’t force users to accept only one option.

If the action related to the dialog is irreversible or removes something, use a critical button to make the consequences clear to users.

A dialog with a warning in the description stating 'You can't do this' and the button is marked as critical (meaning a destructive action).

Do

Warn about destructive actions.

A dialog with no description and actions as normal (even though they're destructive – asking to remove a traveler).

Don't

Don’t offer destruction choices with no warning about the consequences.

Dialogs are best as single actions where the context is clear and doesn’t need a lot of explanation. Don’t overwhelm your users with information.

If more information is absolutely necessary, consider adding a text link.

Do

A dialog with a short title and description.

Don't

A dialog with an title covering three lines and a description with three separate paragraphs.

The title should make it clear what action users are expected to take or what they’re agreeing to. Keep it short and save any details for the description.

Remove insurance?
Add a meal?
Edit passenger name
Are you sure you want to remove your insurance?
Add?
Edit passenger name for this itinerary