Use cases

Scenarios demonstrating the placement and presentation of messaging components on pages, sections, modals, and forms etc.

Page level

Alert list

An alert list, whether containing a single alert list item or multiple alert list items, lives at a page or app level above the UI on the z-axis. On the y-axis, it can be placed directly below the unified navigation or lower if it overlaps with interactive elements like tabs to avoid any conflicts.

Mockup of alert list being displayed in a dashboard with no tabs

Alert list placed below the unified navigation

Mockup of alert list being displayed in a dashboard with tabs

Alert list placed lower below the tabs to avoid overlapping

Message

A message can be used at a page level when there’s no content to display.

Mockup of message being displayed at page level

Empty state at a page level

An alert modal displays information in a layer above the app. This type of interruptive interaction should only be used when it's necessary to take users away from their current workflow in scenarios such as unsaved changes, expired sessions, and confirmation of deletions.

Mockup of a modal being used to show expired sessions

Alert modal for expired sessions


Contextual

Alert

An alert can be used contextually in a section or widget on a page to communicate a message that only applies to the specific context where it’s used.

Mockup of alert message being displayed in a page section

Alert in a section of a page

Mockup of alert message being used in a modal

Alert in a modal

Mockup of alert message being used in a card

Alert in a card

Message

Similar to an alert, a message can also be used contextually in a section or widget on a page. The most frequently used message type is an empty state message that’s used to reserve a dedicated space for content to display later.

Mockup of empty state message displayed in a page section

Empty state message in a section of a page

Mockup of empty state message displayed in a modal

Empty state message in a modal

Mockup of multiple messages displayed in widgets within a page

Multiple messages in widgets on a page

Highlighted value

Highlighted values are most frequently used in a record header, card, and list cell to communicate status or category. They have a small visual footprint but help in drawing the user’s attention.

Mockup of highlighted value displayed in a record header

Highlighted value in the metadata section of a record header

Mockup of highlighted value displayed in cards

Highlighted value in cards

Mockup of highlighted value displayed in list cells

Highlighted value in list cells

Form field messaging

A form field message has the most limited use case among all messaging components as it’s only used in forms. As a render function in form components, it can be used in an input, radio button, etc.

Mockup of form field messaging being displayed below a form's input field

Form field messaging rendered below an input

Mockup of form field messaging being displayed below a form's radio buttons

Form field messaging rendered below a radio button group