Alert

When the user takes an important action (for example when irreversibly deleting something), you can ask for confirmation by using confirmAlert.
API Reference
confirmAlert
Creates and shows a confirmation Alert with the given options.
Signature
async function confirmAlert(options: Alert.Options): Promise<boolean>;
Example
import { confirmAlert } from "@raycast/api";
​
export default async function Command() {
  if (await confirmAlert({ title: "Are you sure?" })) {
    console.log("confirmed");
    // do something
  } else {
    console.log("canceled");
  }
}
Parameters
Name
Description
Type
options*
The options used to create the Alert.
​Alert.Options​
Return
A Promise that resolves to a boolean when the user triggers one of the actions. It will be true for the primary Action, false for the dismiss Action.
Types
Alert.Options
The options to create an Alert.
Example
import { Alert, confirmAlert } from "@raycast/api";
​
export default async function Command() {
  const options: Alert.Options = {
    title: "Finished cooking",
    message: "Delicious pasta for lunch",
    primaryAction: {
      title: "Do something",
      onAction: () => {
        // while you can register a handler for an action, it's more elegant
        // to use the `if (await confirmAlert(...)) { ... }` pattern
        console.log("The alert action has been triggered");
      },
    },
  };
  await confirmAlert(options);
}
Properties
Property
Description
Type
title*
The title of an alert. Displayed below the icon.
string
dismissAction
The Action to dismiss the alert. There usually shouldn't be any side effects when the user takes this action.
​Alert.ActionOptions​
icon
The icon of an alert to illustrate the action. Displayed on the top.
​Image.ImageLike​
message
An additional message for an Alert. Useful to show more information, e.g. a confirmation message for a destructive action.
string
primaryAction
The primary Action the user can take.
​Alert.ActionOptions​
Alert.ActionOptions
The options to create an Alert Action.
Properties
Property
Description
Type
title*
The title of the action.
string
style
The style of the action.
​Alert.ActionStyle​
onAction
A callback called when the action is triggered.
() => void
Alert.ActionStyle
Defines the visual style of an Action of the Alert.
Use Alert.ActionStyle.Default for confirmations of a positive action. Use Alert.ActionStyle.Destructive for confirmations of a destructive action (eg. deleting a file).
Enumeration members
Name
Value
Default
​
​
Destructive
​
​
Cancel
​
​

Name	Description	Type
options*	The options used to create the Alert.	`Alert.Options`

Property	Description	Type
title*	The title of an alert. Displayed below the icon.	`string`
dismissAction	The Action to dismiss the alert. There usually shouldn't be any side effects when the user takes this action.	`Alert.ActionOptions`
icon	The icon of an alert to illustrate the action. Displayed on the top.	`Image.ImageLike`
message	An additional message for an Alert. Useful to show more information, e.g. a confirmation message for a destructive action.	`string`
primaryAction	The primary Action the user can take.	`Alert.ActionOptions`

Property	Description	Type
title*	The title of the action.	`string`
style	The style of the action.	`Alert.ActionStyle`
onAction	A callback called when the action is triggered.	`() => void`

Name	Value
Default
Destructive
Cancel

Last modified 4mo ago