# Dialog
URL: /design/components/dialog

A modal sheet for decisions that need the page to wait.

> For AI agents: a documentation index is available at [llms.txt](/llms.txt). Use `.md` for canonical markdown pages; `.mdx` is kept as a backwards-compatible alias on supported URL paths.

\[interactive preview component DialogSpecimen omitted]

Code for DialogSpecimen preview:

```tsx
"use client";

import { useState, type ReactNode } from "react";
import { Button } from "@/components/ui/button";
import {
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@/components/ui/dialog";
import { Input } from "@/components/ui/input";

function DialogSpecimen(): ReactNode {
  return (
    <Dialog>
      <DialogTrigger
        render={<Button variant="outline">Rename thread</Button>}
      />
      <DialogContent>
        <DialogHeader>
          <DialogTitle>Rename thread</DialogTitle>
          <DialogDescription>
            The new name is visible to everyone in this workspace.
          </DialogDescription>
        </DialogHeader>
        <Input
          defaultValue="Quarterly revenue dashboard"
          aria-label="Thread name"
        />
        <DialogFooter>
          <DialogClose render={<Button variant="ghost">Cancel</Button>} />
          <DialogClose render={<Button>Save</Button>} />
        </DialogFooter>
      </DialogContent>
    </Dialog>
  );
}
```

## Installation

Install the dependencies:

- packages

  - @base-ui/react

Copy the source into `components/ui/dialog.tsx`. Registry items that depend on it install it automatically.

- code

  "use client"; import \* as React from "react"; import { Dialog as DialogPrimitive } from "@base-ui/react/dialog"; import { XIcon } from "lucide-react"; import { Button } from "@/components/ui/button"; import { cn } from "@/lib/utils"; function Dialog({ ...props }: DialogPrimitive.Root.Props) { return \<DialogPrimitive.Root data-slot="dialog" {...props} />; } function DialogTrigger({ ...props }: DialogPrimitive.Trigger.Props) { return \<DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />; } function DialogPortal({ ...props }: DialogPrimitive.Portal.Props) { return \<DialogPrimitive.Portal data-slot="dialog-portal" {...props} />; } function DialogClose({ ...props }: DialogPrimitive.Close.Props) { return \<DialogPrimitive.Close data-slot="dialog-close" {...props} />; } function DialogOverlay({ className, ...props }: DialogPrimitive.Backdrop.Props) { return ( \<DialogPrimitive.Backdrop data-slot="dialog-overlay" className={cn( "data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0 fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs", className, )} {...props} /> ); } function DialogContent({ className, children, showCloseButton = true, ...props }: DialogPrimitive.Popup.Props & { showCloseButton?: boolean; }) { return ( \<DialogPortal> \<DialogOverlay /> \<DialogPrimitive.Popup data-slot="dialog-content" className={cn( "bg-popover text-popover-foreground ring-foreground/10 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 fixed top-1/2 left-1/2 z-50 grid w-full max-w-\[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl p-5 text-sm ring-1 duration-100 outline-none sm:max-w-sm", className, )} {...props} > {children} {showCloseButton && ( \<DialogPrimitive.Close data-slot="dialog-close" render={ \<Button variant="ghost" className="absolute top-2 right-2" size="icon-sm" /> } > \<XIcon /> \<span className="sr-only">Close\</span> \</DialogPrimitive.Close> )} \</DialogPrimitive.Popup> \</DialogPortal> ); } function DialogHeader({ className, ...props }: React.ComponentProps<"div">) { return ( \<div data-slot="dialog-header" className={cn("flex flex-col gap-2", className)} {...props} /> ); } function DialogFooter({ className, showCloseButton = false, children, ...props }: React.ComponentProps<"div"> & { showCloseButton?: boolean; }) { return ( \<div data-slot="dialog-footer" className={cn( "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end", className, )} {...props} > {children} {showCloseButton && ( \<DialogPrimitive.Close render={\<Button variant="outline" />}> Close \</DialogPrimitive.Close> )} \</div> ); } function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props) { return ( \<DialogPrimitive.Title data-slot="dialog-title" className={cn( "cn-font-heading text-base leading-none font-medium", className, )} {...props} /> ); } function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props) { return ( \<DialogPrimitive.Description data-slot="dialog-description" className={cn( "text-muted-foreground \*:\[a]:hover:text-foreground text-sm \*:\[a]:underline \*:\[a]:underline-offset-3", className, )} {...props} /> ); } export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

* title

  components/ui/dialog.tsx

* copyText

  "use client"; import \* as React from "react"; import { Dialog as DialogPrimitive } from "@base-ui/react/dialog"; import { XIcon } from "lucide-react"; import { Button } from "@/components/ui/button"; import { cn } from "@/lib/utils"; function Dialog({ ...props }: DialogPrimitive.Root.Props) { return \<DialogPrimitive.Root data-slot="dialog" {...props} />; } function DialogTrigger({ ...props }: DialogPrimitive.Trigger.Props) { return \<DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />; } function DialogPortal({ ...props }: DialogPrimitive.Portal.Props) { return \<DialogPrimitive.Portal data-slot="dialog-portal" {...props} />; } function DialogClose({ ...props }: DialogPrimitive.Close.Props) { return \<DialogPrimitive.Close data-slot="dialog-close" {...props} />; } function DialogOverlay({ className, ...props }: DialogPrimitive.Backdrop.Props) { return ( \<DialogPrimitive.Backdrop data-slot="dialog-overlay" className={cn( "data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0 fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs", className, )} {...props} /> ); } function DialogContent({ className, children, showCloseButton = true, ...props }: DialogPrimitive.Popup.Props & { showCloseButton?: boolean; }) { return ( \<DialogPortal> \<DialogOverlay /> \<DialogPrimitive.Popup data-slot="dialog-content" className={cn( "bg-popover text-popover-foreground ring-foreground/10 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 fixed top-1/2 left-1/2 z-50 grid w-full max-w-\[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl p-5 text-sm ring-1 duration-100 outline-none sm:max-w-sm", className, )} {...props} > {children} {showCloseButton && ( \<DialogPrimitive.Close data-slot="dialog-close" render={ \<Button variant="ghost" className="absolute top-2 right-2" size="icon-sm" /> } > \<XIcon /> \<span className="sr-only">Close\</span> \</DialogPrimitive.Close> )} \</DialogPrimitive.Popup> \</DialogPortal> ); } function DialogHeader({ className, ...props }: React.ComponentProps<"div">) { return ( \<div data-slot="dialog-header" className={cn("flex flex-col gap-2", className)} {...props} /> ); } function DialogFooter({ className, showCloseButton = false, children, ...props }: React.ComponentProps<"div"> & { showCloseButton?: boolean; }) { return ( \<div data-slot="dialog-footer" className={cn( "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end", className, )} {...props} > {children} {showCloseButton && ( \<DialogPrimitive.Close render={\<Button variant="outline" />}> Close \</DialogPrimitive.Close> )} \</div> ); } function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props) { return ( \<DialogPrimitive.Title data-slot="dialog-title" className={cn( "cn-font-heading text-base leading-none font-medium", className, )} {...props} /> ); } function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props) { return ( \<DialogPrimitive.Description data-slot="dialog-description" className={cn( "text-muted-foreground \*:\[a]:hover:text-foreground text-sm \*:\[a]:underline \*:\[a]:underline-offset-3", className, )} {...props} /> ); } export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

* viewportClassName

  max-h-\[450px]

- language

  tsx

- code

  "use client"; import \* as React from "react"; import { Dialog as DialogPrimitive } from "@base-ui/react/dialog"; import { XIcon } from "lucide-react"; import { Button } from "@/components/ui/button"; import { cn } from "@/lib/utils"; function Dialog({ ...props }: DialogPrimitive.Root.Props) { return \<DialogPrimitive.Root data-slot="dialog" {...props} />; } function DialogTrigger({ ...props }: DialogPrimitive.Trigger.Props) { return \<DialogPrimitive.Trigger data-slot="dialog-trigger" {...props} />; } function DialogPortal({ ...props }: DialogPrimitive.Portal.Props) { return \<DialogPrimitive.Portal data-slot="dialog-portal" {...props} />; } function DialogClose({ ...props }: DialogPrimitive.Close.Props) { return \<DialogPrimitive.Close data-slot="dialog-close" {...props} />; } function DialogOverlay({ className, ...props }: DialogPrimitive.Backdrop.Props) { return ( \<DialogPrimitive.Backdrop data-slot="dialog-overlay" className={cn( "data-open:animate-in data-open:fade-in-0 data-closed:animate-out data-closed:fade-out-0 fixed inset-0 isolate z-50 bg-black/10 duration-100 supports-backdrop-filter:backdrop-blur-xs", className, )} {...props} /> ); } function DialogContent({ className, children, showCloseButton = true, ...props }: DialogPrimitive.Popup.Props & { showCloseButton?: boolean; }) { return ( \<DialogPortal> \<DialogOverlay /> \<DialogPrimitive.Popup data-slot="dialog-content" className={cn( "bg-popover text-popover-foreground ring-foreground/10 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95 fixed top-1/2 left-1/2 z-50 grid w-full max-w-\[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-xl p-5 text-sm ring-1 duration-100 outline-none sm:max-w-sm", className, )} {...props} > {children} {showCloseButton && ( \<DialogPrimitive.Close data-slot="dialog-close" render={ \<Button variant="ghost" className="absolute top-2 right-2" size="icon-sm" /> } > \<XIcon /> \<span className="sr-only">Close\</span> \</DialogPrimitive.Close> )} \</DialogPrimitive.Popup> \</DialogPortal> ); } function DialogHeader({ className, ...props }: React.ComponentProps<"div">) { return ( \<div data-slot="dialog-header" className={cn("flex flex-col gap-2", className)} {...props} /> ); } function DialogFooter({ className, showCloseButton = false, children, ...props }: React.ComponentProps<"div"> & { showCloseButton?: boolean; }) { return ( \<div data-slot="dialog-footer" className={cn( "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end", className, )} {...props} > {children} {showCloseButton && ( \<DialogPrimitive.Close render={\<Button variant="outline" />}> Close \</DialogPrimitive.Close> )} \</div> ); } function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props) { return ( \<DialogPrimitive.Title data-slot="dialog-title" className={cn( "cn-font-heading text-base leading-none font-medium", className, )} {...props} /> ); } function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props) { return ( \<DialogPrimitive.Description data-slot="dialog-description" className={cn( "text-muted-foreground \*:\[a]:hover:text-foreground text-sm \*:\[a]:underline \*:\[a]:underline-offset-3", className, )} {...props} /> ); } export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

## Usage

```
import {
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@/components/ui/dialog";
import { Button } from "@/components/ui/button";

export function Example() {
  return (
    <Dialog>
      <DialogTrigger render={<Button variant="outline">Rename</Button>} />
      <DialogContent>
        <DialogHeader>
          <DialogTitle>Rename thread</DialogTitle>
          <DialogDescription>Visible to everyone in this workspace.</DialogDescription>
        </DialogHeader>
        <DialogFooter>
          <DialogClose render={<Button variant="ghost">Cancel</Button>} />
          <DialogClose render={<Button>Save</Button>} />
        </DialogFooter>
      </DialogContent>
    </Dialog>
  );
}
```

## API Reference

The parts wrap Base UI's Dialog primitives and accept their props.

### Dialog

- `open?`: `boolean` — Controlled open state.
- `onOpenChange?`: `(open: boolean) => void` — Called when the open state changes, including Escape and backdrop clicks.
- `defaultOpen`: `boolean` (default `false`) — Uncontrolled initial open state.

### Parts

| Part            | Description                                        |
| --------------- | -------------------------------------------------- |
| `DialogTrigger` | Opens the dialog; compose a control with `render`. |
| `DialogContent` | The centered panel at the dialog radius.           |
| `DialogHeader`  | Title and description stack.                       |
| `DialogFooter`  | Right-aligned action row.                          |
| `DialogClose`   | Wraps any control that should dismiss.             |