Creating toolbar items - chrisgurney/obsidian-note-toolbar GitHub Wiki

After setting a Name for the toolbar, in the Items section, click the + Add button to start to add items to it, or Search to find an item in an existing toolbar, or to search the Gallery.

Alternately import items by importing callout markdown using the import button .

To add separators and line breaks, use the buttons/icons in the lower left.

[!tip] Directly on the toolbar you can also right-click (long press on mobile) to:

Add item, to add a new or existing item where you clicked/tapped; or

Edit item, to make changes to an existing item.

Field / Button	What it does
Icon	(Optional) Choose an icon to use, from Obsidian's icon library. If a label is also set, the icon will be displayed to the left of the label.
Label	(Optional) Set text to use for this item. 💡 Tip: If you'd rather use emojis, enter them in place of, or in addition to, a label.
Tooltip	(Optional) Displayed on hovering over the item on the toolbar. Nothing is displayed if this is not set. 💡 Tip: If you choose not to use labels it's recommended that you set tooltips, as this text is used in menus.
Item Type (dropdown)	Select the type of this item. See Item Types below for more details. Fields will appear relevant to each type.
Change desktop visibility (desktop icon)	Click this icon to toggle icon and label visibility on desktop, or to completely hide this item on desktop.
Change mobile visibility (mobile icon)	Click this icon to toggle icon and label visibility on mobile (phone and tablet), or to completely hide this item on mobile. 💡 Tip: Use this to hide items that just don't work on mobile (e.g., Shell Commands).
Duplicate this item	Makes a copy of the item.

[!tip] Tooltips and labels support use of variables, Dataview expressions, JavaScript expressions, JS Engine expressions, and Templater commands.

[!tip] Visibility settings work well when accessing toolbars from the floating button and nav bar, where you will probably want to display text labels (or tooltips if label is not set) next to icons in the menu.

Item Types

Command

See: Command items

Dataview

If the Dataview plugin is installed and enabled, after selecting Dataview you can configure an item to execute Dataview queries, expressions, and scripts.

JS Engine

If the JS Engine plugin is installed and enabled, after selecting JS Engine you can configure an item to execute JavaScript via JS Engine.

Templater

If the Templater plugin is installed and enabled, after selecting Templater you can configure an item to insert templates, create new notes from templates, and execute Templater commands.

URI

See: URI items

Add toolbar decoration

Add via the icons in the lower left of the item list:

Break

Adds a line break, which forces the toolbar to be displayed over multiple lines.

Notes:

Visibility can be set to desktop/mobile/both.
Breaks are displayed as separators within menus.
If you use the nowrap style (on mobile) you will not see line breaks.

Separator

Adds a small vertical line between toolbar items. This allows you to visually group items in the toolbar depending on their function, for example.