AlertDialog

1.0.0

A modal that interrupts the page to confirm a destructive or high-impact action before it proceeds.

Component data

ID
alert-dialog
Category
atoms
Version
1.0.0
Added
2026-09-17
Type
component
Keyboard nav
Yes
Reduced motion
Yes
alert-dialogmodalconfirmoverlayatom

Dependencies

  • @base-ui/react
  • clsx
  • tailwind-merge
  • react

Registry

  • button

Examples

Default

<AlertDialog>
      <AlertDialogTrigger
        render={
          <Button variant="secondary">
            {alertDialogMocks.default.trigger}
          </Button>
        }
      />
      <AlertDialogContent>
        <AlertDialogHeader>
          <AlertDialogTitle>{alertDialogMocks.default.title}</AlertDialogTitle>
          <AlertDialogDescription>
            {alertDialogMocks.default.description}
          </AlertDialogDescription>
        </AlertDialogHeader>
        <AlertDialogFooter>
          <AlertDialogCancel>
            {alertDialogMocks.default.cancel}
          </AlertDialogCancel>
          <AlertDialogAction>
            {alertDialogMocks.default.confirm}
          </AlertDialogAction>
        </AlertDialogFooter>
      </AlertDialogContent>
    </AlertDialog>

Variants

<div className="flex flex-wrap items-center gap-3">
      <AlertDialog>
        <AlertDialogTrigger
          render={
            <Button variant="secondary">
              {alertDialogMocks.small.trigger}
            </Button>
          }
        />
        <AlertDialogContent size="sm">
          <AlertDialogHeader>
            <AlertDialogMedia>
              <BluetoothIcon />
            </AlertDialogMedia>
            <AlertDialogTitle>{alertDialogMocks.small.title}</AlertDialogTitle>
            <AlertDialogDescription>
              {alertDialogMocks.small.description}
            </AlertDialogDescription>
          </AlertDialogHeader>
          <AlertDialogFooter>
            <AlertDialogCancel>
              {alertDialogMocks.small.cancel}
            </AlertDialogCancel>
            <AlertDialogAction>
              {alertDialogMocks.small.confirm}
            </AlertDialogAction>
          </AlertDialogFooter>
        </AlertDialogContent>
      </AlertDialog>
      <AlertDialog>
        <AlertDialogTrigger
          render={
            <Button variant="destructive">
              {alertDialogMocks.destructive.trigger}
            </Button>
          }
        />
        <AlertDialogContent size="sm">
          <AlertDialogHeader>
            <AlertDialogMedia className="bg-destructive/10 text-destructive">
              <Trash2Icon />
            </AlertDialogMedia>
            <AlertDialogTitle>
              {alertDialogMocks.destructive.title}
            </AlertDialogTitle>
            <AlertDialogDescription>
              This will permanently delete this chat conversation. View{" "}
              <a href="#settings">Settings</a> to delete any memories saved
              during this chat.
            </AlertDialogDescription>
          </AlertDialogHeader>
          <AlertDialogFooter>
            <AlertDialogCancel variant="ghost">
              {alertDialogMocks.destructive.cancel}
            </AlertDialogCancel>
            <AlertDialogAction variant="destructive">
              {alertDialogMocks.destructive.confirm}
            </AlertDialogAction>
          </AlertDialogFooter>
        </AlertDialogContent>
      </AlertDialog>
    </div>

Related