Recommendations

Guidance for incorporating messaging into your design.

Alert showing the default checkmark icon
Do

It’s best to use default icons. If you need to use a custom, consider using one that’s a container with a symbol inside.

Alert showing a customized checkmark icon
Don’t

Don’t use custom icons in alert, alert list, and form field messaging components unless they’re for special cases.

a mockup with the alert placed appropriately
Do

Position alerts 16px below the unified navigation or tabs so that it won’t conflict with them.

a mockup with the alert placed too low down on the page, overlapping the tabs area
Don’t

Don’t place an alert list too high or low where it blocks other interactive elements or visually appears awkward.

a mockup of an alert that has the appropriate width
Do

Ensure a minimum width of 1/3 of the viewport area.

a mockup of an alert that is too narrow because it hugs the content
Don’t

Don’t have an alert list item hug content when message content is short. It’s easily missed on the page.

a mockup of stacked alerts where they are all the same width
Do

Make all stacked alert list items the same width.

a mockup of stacked alerts where the widths are varying
Don’t

Don’t have stacked alert list items in varying widths. This hinders the readability of message content.

mockup of a modal with text (message) content placed directly in the modal body
Do

Place the message directly in the modal body.

mockup of a modal with an alert placed directly in the modal body
Don’t

Don’t use an alert component as the single element in a modal.

a mockup of a page with a positive, informative alert
Do

Alerts containing less important information like a simple success message can be auto-dismissed if desired.

a mockup of a page with a negative, important alert
Don’t

Don’t auto-dismiss alerts containing important information. They will be easily missed.

A form field showing an error message below; the message width matches the form field width
Do

Make sure that the width of a form field message matches the width of its parent component.

A form field showing an error message below; the message width is shorter than the form field width
Don’t

Don’t have a form field messaging component hug content which causes the message to have a different width than its parent component.

a mockup of an empty content area containing the appropriate use of an empty state component
Do

Use an empty state component to reserve a dedicated space where there’s no content to display.

a mockup of an empty content area containing the inappropriate use of an alert component
Don’t

Don’t use an alert component in an area where there’s no content to display.