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 for the desktop layout#

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.

Mobile layout#

Custom launch bar widgets are also supported on the Mobile Frontend. To do so:

1. Go to Global menu → Advanced → Show Hidden Subtree.
2. Look for Mobile Launch Bar and follow the same creation mechanism as in the previous section.