Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Components

Modal

use: best-practice Web
A modal disables page content and focuses the user’s attention on a single task or message.

Examples

Default

View va-modal in Storybook

Info

View va-modal info in Storybook

Continue

View va-modal continue in Storybook

Success

View va-modal success in Storybook

Warning

View va-modal warning in Storybook

Error

View va-modal error in Storybook

Click outside to close

View va-modal click outside to close in Storybook

Without buttons

View va-modal without buttons in Storybook

Without title

View va-modal without title in Storybook

With nested web components

View va-modal with nested web components in Storybook

Large

View va-modal large in Storybook

With forced action

View va-modal with forced action in Storybook

Usage

Additional guidance for VA

When to consider something else

  • Content that must be linkable (have a distinct URL) or searchable. Modals cannot be linked to or searched.
  • Modals should not contain long forms. Modal content must be brief and not include complicated interactions.

Code usage

Accessibility considerations

Provide feedback

Share your feedback, report issues, or suggest improvements for the Modal component. Your input helps us make the design system better for everyone.

Edit this page in GitHub (Permissions required)
Last updated: May 14, 2026