Ready

Modal

Modals display required decisions, critical information or important tasks. Modals allow users to view and interact with content without navigating away from the page below the Modal.

Ready

Modal

Modals display required decisions, critical information or important tasks. Modals allow users to view and interact with content without navigating away from the page below the Modal.

Anatomy

  1. Heading

  2. Content

  3. Footer

  4. Dismiss control

States

Best Practices

1

Usage

Use modals sparingly. Modals are purposely interruptive and should only be used for content that requires the users full attention.

2

Decisions

Decision modals should not be use to display simple help text, notifications or confirmations. For these types of messages, consider using Message cards or Flash messages.

Do

3

Information

Information modals should only be used for complex content. For simple content, consider using a side panel to allow the user to continue interacting with the page content.

Do

4

Tasks

Task modals should only be used for complex tasks with multiple inputs. For smaller tasks with a single input, consider using a popover or an in-line edit mode.

Do

5

Single Action

Task modals with only one action should use a primary button. This button should be aligned to the right side of the footer.

Do

Don't

6

Back Control

When the user has advanced a step in a workflow or navigated down a level in the modal hierarchy, then a back control button may be provided.

Do

Content

1

Information modals

Information modals contain a lot of information or very complex information. Examples of information modals would be lists of reports, a user’s contact information, or deal details. These modals don’t require user action, though there can be buttons that allow the user to do something, such as Edit. They can also include a button that allows the user to exit, which should be labeled Close.

2

Information modal headers

Information modals can include super headers. The super header indicates the type or category of the item that the user is looking at. For example, Property, Vendor, or Contact. The main heading for these types of modals should be the name of the selected item itself, so the super header provides a general description of the modal.

Do

3

Task modals

Task modals should be used for complex tasks with multiple inputs. The heading conveys the purpose of the modal and the action that users can expect to take. It should align with the button, but it doesn't have to be identical. Keep the heading as short as possible while clearly describing the modal. In general, these types of modals do not require super headers.

For confirmation modals, the heading should take the form of a question. See Confirmation Messages.

The button should allow the user to complete the action, confirm their choices, or acknowledge their understanding of the modal’s content. The button label should align with the action described in the modal header.

© 2026 Basis Technologies
© 2026 Basis Technologies
© 2026 Basis Technologies