Modal

A dialog that appears above the page content, either centred on screen or anchored to the bottom as a mobile sheet. Supports a feature icon badge, image or stacked-avatar header, rich body content via the children slot, and flexible action button layouts.

Default

The standard dialog — feature icon, title, description, and two action buttons.

Icon variants

Four semantic colour roles — primary, success, warning, and error.

Destructive

Pass isDestructive to make the primary action button render in the danger colour.

Horizontal layout

Set layout="horizontal" to place the icon to the left of all content. Wider modal (size="lg") is recommended.

Bottom sheet

position="bottom" anchors the modal to the bottom of the viewport — ideal for mobile interactions. Use actionsLayout="vertical" to stack the buttons.

Centered

align="center" horizontally centres the icon and all text.

Actions with checkbox

actionsLayout="horizontal-with-checkbox" places a checkbox on the left and the buttons on the right. Pass the controlled checkbox state from the parent.

User avatar

Pass userAvatar to render a name/avatar row below the description — useful for access-request or confirmation dialogs.

Team avatars

Pass up to three items in avatarGroup to render a stacked avatar fan instead of the icon badge.

Image

Pass image to render a full-width cover image at the top.

Children — checkbox list

Use the children slot to embed a list of checkboxes or other selection controls.

Custom content

The children slot renders any content between the description and the actions row — forms, checkbox lists, OTP inputs, and more.

Children — OTP input

Embed a verification code UI in children alongside a centred layout.