Toast guidelines

This page documents patterns for using toasts, short messages that appears on the lower right corner and time out after a few seconds. They are a popular design choice because they don't need to fit in a layout and don't disrupt the user.

Toast types

A new notification appears

Your report is complete

Success toasts indicate that everything worked out

They are the most-commonly used toasts.

A new notification appears

Node 726 is having trouble

Warning toasts direct user attention to a potential problem

These toasts work well in monitoring apps when something significant requires action.

A new notification appears

Search failed. Check your Elasticsearch connection.

Error toasts report a problem

An error toast might let users know an action didn't complete or that a form has errors.

A new notification appears

Please wait while your report is created

Info toasts relay neutral information

The default toast, an info toast might notify users about an ongoing action.

Use a toast for a timely message

Toasts are appropriate for short feedback related to a user action. A toast should contain a message about a current action, not a historical action.

A new notification appears

Your folder was moved
Do. Use a toast for a brief message about the current action.

A new notification appears

Haven't seen you in a while
Don't greet users with a toast when they open a page.

Most often, it's a single line of text

By default, a toast stays on the screen 10 seconds. Users should be able read the message in 6 to 7 seconds. The message should get straight to the point and rarely include more than one line.

A new notification appears

Check your form for errors
Do. A single line of text is readable at a glance.

A new notification appears

Your form has errors
  • Username is a required field.
  • Password must be at least 6 characters long.
  • Email is a required field.
Don't cram a lot of detail into a toast. These errors should persist in callouts and validations on the form. They don't need to be spelled out in the toast.

Toasts should only contain a single action

A toast can have a single action, styled as a standard button. If more actions are needed, or if the action is important enough to interrupt the user, use a modal instead.

A new notification appears

Your report is complete
Do. Use only one action per toast and favor a one-word label. Align actions to the right, which follows our button guidelines for usage within restricted width containers.

A new notification appears

All messages will be deleted
Don't use multiple actions. Don't align buttons in toasts to the left. This message is better in a confirmation modal.

Icons should emphasize actions

An icon on the left of the message can help define the message type.

A new notification appears

Your dashboard was updated

A new notification appears

A dashboard named 'MyDashboard' already exists
Do. The check icon reinforces that the action succeeded. The alert icon helps users understand the message is an error.

A new notification appears

Message sent
Don't use icons that are hard to understand. They distract from the message.

Display one toast at a time

Users should be able to take in all the details from one toast before the next one arrives.

A new notification appears

3 new messages
Do. Display one toast at a time.

A new notification appears

There was a problem with your node

A new notification appears

3 new messages
Don't stack toasts.

Keep messages as short as possible

For common actions such as create, add, delete, remove, and save, include the object type, the object name if available, and the past tense of the action.

A new notification appears

User 'Casey Smith' was added
Do. Include the object name if it's not too long. Use single quotation marks around the object name if it helps clarify meaning.

A new notification appears

Your object has been saved
Don't use the generic "Your object."

Don't include the word "successfully." It's implied.

A new notification appears

Dashboard 'My_dashboard_with_a_very_long_name' was saved
Do. Use this format for a success message.

A new notification appears

Dashboard 'My_dashboard' was successfully saved
Don't include "successfully."

For a message about multiple objects, include the object count, but not the names of the objects.

A new notification appears

4 visualizations were deleted
Do. Include the object count.

A new notification appears

Visualization 1, Visualization 2, Visualization 3, and Visualization 4 were deleted
Don't overwhelm the user by listing the names of all the objects.

Use call-to-action buttons when the content needs more room

Occassionally the content of a toast is too involved to fit into the constrained space of a toast. This is common in long error messages. In these cases use the toast to deliver the summary of the information and use a button to provide a call-to-action for the full message.

A new notification appears

Your visualization has an error

The maximum bucket size of 200 was exceeded.

Use the toast message to provide a summary and a button to link to the full content

A new notification appears

Your visualization has an error
The maximum bucket size of 200 was exceeded

An extremely long error trace.

Don't cram a lot of content into the small space of a toast.