Display important messages and notifications to users with status indicators
Import
import { Alert } from "heroui-solid";Usage
New features available
Check out our latest updates including dark mode support and improved accessibility features.Update available
A new version of the application is available. Please refresh to get the latest features and bug fixes.Unable to connect to server
We're experiencing connection issues. Please try the following:- Check your internet connection
- Refresh the page
- Clear your browser cache
Profile updated successfully
Processing your request
Please wait while we sync your data. This may take a few moments.Scheduled maintenance
Our services will be unavailable on Sunday, March 15th from 2:00 AM to 6:00 AM UTC for scheduled maintenance.import { Alert, Button, CloseButton, Spinner } from "heroui-solid"
export function Basic() {
return (
<div class="grid w-full max-w-xl gap-4">
{/* Default - General information */}
<Alert>
<Alert.Indicator />
<Alert.Content>
<Alert.Title>New features available</Alert.Title>
<Alert.Description>
Check out our latest updates including dark mode support and
improved accessibility features.
</Alert.Description>
</Alert.Content>
</Alert>
{/* Accent - Important information with action */}
<Alert status="accent">
<Alert.Indicator />
<Alert.Content>
<Alert.Title>Update available</Alert.Title>
<Alert.Description>
A new version of the application is available. Please refresh to get
the latest features and bug fixes.
</Alert.Description>
<Button class="mt-2 sm:hidden" size="sm" variant="primary">
Refresh
</Button>
</Alert.Content>
<Button class="hidden sm:block" size="sm" variant="primary">
Refresh
</Button>
</Alert>
{/* Danger - Error with detailed steps */}
<Alert status="danger">
<Alert.Indicator />
<Alert.Content>
<Alert.Title>Unable to connect to server</Alert.Title>
<Alert.Description>
We're experiencing connection issues. Please try the following:
<ul class="mt-2 list-inside list-disc space-y-1 text-sm">
<li>Check your internet connection</li>
<li>Refresh the page</li>
<li>Clear your browser cache</li>
</ul>
</Alert.Description>
<Button class="mt-2 sm:hidden" size="sm" variant="danger">
Retry
</Button>
</Alert.Content>
<Button class="hidden sm:block" size="sm" variant="danger">
Retry
</Button>
</Alert>
{/* Without description */}
<Alert status="success">
<Alert.Indicator />
<Alert.Content>
<Alert.Title>Profile updated successfully</Alert.Title>
</Alert.Content>
<CloseButton />
</Alert>
{/* Custom indicator - Loading state */}
<Alert status="accent">
<Alert.Indicator>
<Spinner size="sm" />
</Alert.Indicator>
<Alert.Content>
<Alert.Title>Processing your request</Alert.Title>
<Alert.Description>
Please wait while we sync your data. This may take a few moments.
</Alert.Description>
</Alert.Content>
</Alert>
{/* Without close button */}
<Alert status="warning">
<Alert.Indicator />
<Alert.Content>
<Alert.Title>Scheduled maintenance</Alert.Title>
<Alert.Description>
Our services will be unavailable on Sunday, March 15th from 2:00 AM
to 6:00 AM UTC for scheduled maintenance.
</Alert.Description>
</Alert.Content>
</Alert>
</div>
)
}Anatomy
Import the Alert component and access all parts using dot notation.
import { Alert } from "heroui-solid";
export default () => (
<Alert>
<Alert.Indicator />
<Alert.Content>
<Alert.Title />
<Alert.Description />
</Alert.Content>
</Alert>
);Related Components
- CloseButton: Button for dismissing overlays
- Button: Allows a user to perform an action
- Spinner: Loading indicator
Styling
Passing Tailwind CSS classes
import { Alert } from "heroui-solid";
function CustomAlert() {
return (
<Alert class="border-2 border-blue-500 rounded-xl" status="accent">
<Alert.Indicator class="text-blue-600" />
<Alert.Content class="gap-1">
<Alert.Title class="font-bold text-lg">Custom Alert</Alert.Title>
<Alert.Description class="text-sm opacity-80">
This alert has custom styling applied
</Alert.Description>
</Alert.Content>
</Alert>
);
}Customizing the component classes
To customize the Alert component classes, you can use the @layer components directive.
Learn more.
@layer components {
.alert {
@apply rounded-2xl shadow-lg;
}
.alert__title {
@apply font-bold text-lg;
}
.alert--danger {
@apply border-l-4 border-red-600;
}
}HeroUI follows the BEM methodology to ensure component variants and states are reusable and easy to customize.
CSS Classes
The Alert component uses these CSS classes (View source styles):
Base Classes
.alert- Base alert container.alert__indicator- Icon/indicator container.alert__content- Content wrapper for title and description.alert__title- Alert title text.alert__description- Alert description text
Status Variant Classes
.alert--default- Default gray status.alert--accent- Accent blue status.alert--success- Success green status.alert--warning- Warning yellow/orange status.alert--danger- Danger red status
Interactive States
The Alert component is primarily informational and doesn't have interactive states on the base component. However, it can contain interactive elements like buttons or close buttons.
API Reference
Alert Props
| Prop | Type | Default | Description |
|---|---|---|---|
status | "default" | "accent" | "success" | "warning" | "danger" | "default" | The visual status of the alert |
class | string | - | Additional CSS classes |
children | JSX.Element | - | The alert content |
as | ValidComponent | "div" | Overrides the default DOM element (Kobalte polymorphic) |
Alert.Indicator Props
| Prop | Type | Default | Description |
|---|---|---|---|
class | string | - | Additional CSS classes |
children | JSX.Element | - | Custom indicator icon (defaults to status icon) |
Alert.Content Props
| Prop | Type | Default | Description |
|---|---|---|---|
class | string | - | Additional CSS classes |
children | JSX.Element | - | Content (typically Title and Description) |
Alert.Title Props
| Prop | Type | Default | Description |
|---|---|---|---|
class | string | - | Additional CSS classes |
children | JSX.Element | - | The alert title text |
Alert.Description Props
| Prop | Type | Default | Description |
|---|---|---|---|
class | string | - | Additional CSS classes |
children | JSX.Element | - | The alert description text |
Differences from HeroUI React
- Use
classinstead ofclassName; the element type is overridden with Kobalte's polymorphicasprop instead of React'srenderprop. - All parts accept
asfor custom elements (e.g.<Alert.Title as="h3">).
Last updated: 7/19/26, 3:27 AM