CommandPalette

isOpen

boolean

Default: —

Whether the palette is shown.

onClose

() => void

Default: —

Fired on Escape, outside click, and after a selection.

onSelect

(item) => void

Default: —

Fired on activation, after the item's own onSelect.

filter

(items, query) => items

Default: built-in fuzzy

Replace the matcher; return the items to show, already ordered.

isLoading

boolean

Default: false

Spinner in the input; suppresses the empty message.

onQueryChange

(query) => void

Default: —

Fired as the query changes.

closeOnEscape / closeOnOutsideClick / portal / container / zIndex / blur

—

Default: —

Passed through to Backdrop.

hotkey

"mod+k" | string | false

Default: "mod+k"

Global open/toggle shortcut. mod = ⌘ on Apple platforms, Ctrl elsewhere. false binds nothing.

defaultOpen

boolean

Default: false

Initial open state.

onOpenChange

(open) => void

Default: —

Fired when the open state changes.

items

CommandPaletteItem[]

Default: —

The commands and destinations.

query / defaultQuery

string

Default: ""

Controlled / initial query.

emptyQueryItems

CommandPaletteItem[]

Default: all items

List shown while the query is empty (recent / suggested).

placeholder

string

Default: "Type a command or search…"

Input placeholder.

emptyMessage

ReactNode

Default: "No results"

Shown when nothing matches.

footer

ReactNode

Default: —

Content below the list.

size

"sm" | "md" | "lg"

Default: md

Palette width (480 / 600 / 720).

ariaLabel

string

Default: "Command palette"

Accessible name for the dialog and listbox.

classNames

{ base?, header?, input?, list?, group?, item?, … }

Default: —

Slot classes.