Skip to content

Sharing toolbars

Chris Gurney edited this page May 29, 2025 · 30 revisions

Share toolbars with a link that you can send to other users.

Right-click on a toolbar and select the Share option, or use the new "More" (...) menu in Settings when hovering over a toolbar in the toolbar list.

Tip

If you prefer, you can also copy a toolbar as a callout and share those with other users. Just review the Copy as callout settings prior to sharing.

Share options

Use Obsidian URI

Toggle this option to change the link to either an https:// or an obsidian:// link.

  • https:// links can be pasted into more places, including chats and discussion forums.
  • obsidian:// links may have to be copied and pasted first. They can be pasted straight into a browser's address bar, or linked from an Obsidian note.

How sharing works

Toolbars are shared as Note Toolbar Callouts, encoded in the link.

See how Note Toolbar copies to callouts, but there are minor differences when sharing as a link:

  • Menu items are shared using their names (versus their IDs), to give the recipient more context as to what the menu was for.
  • A warning message is displayed if the share link exceeds 2,048 characters (i.e., for larger toolbars), which some browsers apparently don't support; Chrome and Safari seem fine though.
  • Note: When pasting long https:// links directly into Obsidian, the editor seems to divide the link into clickable parts (of 512 characters each). You'll have to put the URL in a markdown link, in order to make it clickable.

What the recipient sees when clicking on a link

When users click on the link, they're prompted for confirmation and a preview of the toolbar.

Once confirmed:

  • The toolbar's settings window will appear.
  • Command items are highlighted if the recipient does not already have the plugin installed and enabled.
    • If the command looks valid, a link will be shown link to the plugin's Community Plugins page, so the recipient can review and install/enable it if they so choose.
  • Other items may be highlighted if they're invalid.

The toolbar will still need to be mapped, or its name added to a Note Toolbar property, in order to display the toolbar in their notes.


Read next: Executing scripts

Clone this wiki locally