NV NVIDIA Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles CDN Custom Elements Eleventy Golang HTMX + Go Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About What’s New Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions DESIGN.md Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Codeblock Color Combobox Copy Button Datagrid Getting Started Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Bytes Datetime Number Relative Time Truncate Forms Getting Started Validation Actions Control Gauge Icon Icon Button Input Input Group Logo Markdown Markdown CSS Media Controller Pause Button Playback Rate Select Mute Button Seek Button Time Range Volume Range Full-screen Button Menu Month Monaco Input Diff Input Monaco Editor Diff Editor Problems Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Alert

stable:  2.7.3 Coverage: 88.88% Bundle: 23.69kb Lighthouse: 100 Axe Core Released: 0.3.0
Overview API Examples

Alert is an element that displays a brief, important message in a way that attracts the user's attention without interrupting the user's task.

alert message

Installation

CLI / MCP / CDN

Support Status

Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.

Status Description accent Highlights important actions or draws attention to primary interactive elements. warning Indicates cautionary actions that require careful consideration before proceeding. success Represents positive outcomes, confirmations, or constructive actions. danger Signals destructive or irreversible actions that need extra attention and confirmation.

Alert status variants for semantic messaging. Use accent for informational updates, warning for cautionary messages requiring attention, success for confirmations, and danger for errors or critical issues that may block user progress.

Standard Accent Warning Success Danger

Status

Defines visual treatment to represent a ongoing task or support status.

Status Description accent Highlights important actions or draws attention to primary interactive elements. warning Indicates cautionary actions that require careful consideration before proceeding. success Represents positive outcomes, confirmations, or constructive actions. danger Signals destructive or irreversible actions that need extra attention and confirmation. scheduled Task has a scheduled future execution at a specific time. queued Task is waiting in line to begin after other tasks complete. pending Task is awaiting approval, user input, or external conditions before proceeding. starting Task is initializing and preparing to begin active execution. running Task is actively executing and making progress. restarting Task restarts after an interruption or reset. stopping Task is gracefully shutting down and completing cleanup operations. finished Task has completed successfully with the expected outcome. failed Task encountered an error and did not complete as intended. unknown Task status remains unknown or unavailable. ignored Task was intentionally skipped or excluded from execution. muted

Extended status variants for workflow and process state communication. Use these specialized states (scheduled, queued, running, failed, etc.) in dashboards, build pipelines, or task management interfaces where users need detailed visibility into process lifecycle stages.

Standard Accent Warning Success Danger Scheduled Queued Finished Failed Unknown Pending Starting Running Restarting Stopping Ignored

Alert Group

Alert group for visually organizing related messages with shared styling. Use alert groups to present many related messages as a cohesive unit, improving scannability and visual hierarchy.

alert message

Alert Group Status

Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.

Status Description accent Highlights important actions or draws attention to primary interactive elements. warning Indicates cautionary actions that require careful consideration before proceeding. success Represents positive outcomes, confirmations, or constructive actions. danger Signals destructive or irreversible actions that need extra attention and confirmation.

Alert groups with inherited status styling for all children. Applying status at the group level ensures visual consistency across related messages, perfect for form validation where many fields share the same error context.

Standard Standard Accent Accent Warning Warning Success Success Danger Danger

Invoker Command

Dismissible alerts using the Invoker Command API for declarative close behavior. Use commandfor and command="--close" on action buttons to dismiss individual alerts without custom JavaScript event handling.

Alert Notification Message 1 Alert Notification Message 2

Closable

Indicates whether the user can dismiss or close the element.

Closable Description true The element displays a close control and the user can dismiss it. false The user cannot close the element and must dismiss it programmatically.

Closable alerts that users can dismiss. Use closable alerts for messages that become irrelevant after reading (like onboarding tips, one-time announcements, or acknowledged warnings), but avoid for critical errors that need to remain visible until resolved.

Standard Standard Accent Accent Warning Warning Success Success Danger Danger

Actions

Actions render on the right side of the alert. Actions are typically buttons, but can also be links. Use actions for steps the user can take to resolve the alert.

Alerts with action buttons for immediate user response. Include actions when the alert requires user decision-making (like "Retry", "View Details", or "Undo"), making the next step clear and reducing friction in error recovery or task completion flows.

Standard action Standard action Warning action Success action Danger action

Prominence

Determines the visual prominence or weight, emphasis applies banner style alerts

Prominence Description emphasis

High-prominence alerts with emphasis styling for full-width banners. Use prominence="emphasis" for system-wide announcements like maintenance windows, feature launches, or critical security updates that need max visibility and impact across the entire interface.

Standard banner message view details Accent banner message view details Warning banner message view details Success banner message view details Danger banner message view details

Content

Content for large overflow text.

Alert with complex structured content including expandable details. Use the content slot for rich information like stack traces, validation summaries, or detailed error logs where users need both the high-level message and access to technical details for debugging or reporting.

Session Paused:

Failed to verify drives.

10:06:01 AM [verify] update /virtual:/verify/
10:06:11 AM [build] update /virtual:/build/
10:06:22 AM [error] update /virtual:/error/ - failed to connect to remote
Collapse Details

Color

Defines a base color from the theme color palette

Color Description red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green

Custom color variants for brand-specific styling or extra visual differentiation beyond standard status colors. Use custom colors when standard semantic colors don't match your use case, such as category labels, team assignments, or brand-specific messaging.

red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green

Custom Colors

Custom color combinations with status icons and prominence for advanced theming. Custom colors interact with status icons and emphasis styling, useful for maintaining brand consistency while preserving semantic meaning through status indicators.

Custom color will theme the closable icon. Custom color is compatible with actions button. action Combining custom color="pink-rose" with status yields the status icon with custom alert color. Combining custom color="pink-rose" with status yields the status icon with custom alert color. Combining custom color="pink-rose" with status yields the status icon with custom alert color. Combining custom color="pink-rose" with status yields the status icon with custom alert color. Combining custom color="blue-indigo" with status and prominence yields the status icon with an emphasized custom alert color. Combining custom color="blue-indigo" with status and prominence yields the status icon with an emphasized custom alert color. Combining custom color="blue-indigo" with status and prominence yields the status icon with an emphasized custom alert color. Combining custom color="blue-indigo" with status and prominence yields the status icon with an emphasized custom alert color.

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days