trilium/docs/User Guide/User Guide/Scripting/Frontend Basics/Launch Bar Widgets.md

Launch Bar Widgets

Launch bar widgets are a subset of Custom Widgets that can be used to render custom buttons and widgets inside the Launch Bar.

Creating a launch bar widget

Unlike Custom Widgets, the process of setting up a launch bar widget is slightly different:

1. Create a Code note of type JavaScript (front-end) or JSX (for Preact-based widgets).
   • The script itself uses the same concepts as Custom Widgets, including the use of a NoteContextAwareWidget or a BasicWidget (according to needs).
   • As examples in both legacy and Preact format, see Note Title Widget and Analog Watch.
2. Don't set #widget, as that attribute is reserved for Custom Widgets.
3. In the Global menu, select Configure launchbar.
4. In the Visible Launchers section, select Add a custom widget.
5. Give the newly created launcher a name (and optionally a name).
6. In the Promoted Attributes section, modify the widget field to point to the newly created note.
7. Refresh the UI.