Links

HUD

When the user takes an action that has the side effect of closing Raycast (for example when copying something in the Clipboard), you can use a HUD to confirm that the action worked properly.

API Reference

showHUD

A HUD will automatically hide the main window and show a compact message at the bottom of the screen.

Signature

async function showHUD(title: string, options?: { clearRootSearch?: boolean; popToRootType?: PopToRootType }): Promise<void>;

Example

import { showHUD } from "@raycast/api";
export default async function Command() {
await showHUD("Hey there 👋");
}
showHUD closes the main window when called, so you can use the same options as closeMainWindow:
import { showHUD } from "@raycast/api";
export default async function Command() {
await showHUD("Hey there 👋", { clearRootSearch: true, PopToRootType.Immediate });
}

Parameters

Name
Description
Type
title*
The title that will be displayed in the HUD.
string
options
Can be used to control the behaviour after closing the main window.
Object
options.clearRootSearch
Clears the text in the root search bar and scrolls to the top
boolean
options.popToRootType
Defines the pop to root behavior (PopToRootType); the default is to to respect the user's "Pop to Root Search" preference in Raycast

Return

A Promise that resolves when the HUD is shown.
Last modified 9d ago