-
-
Notifications
You must be signed in to change notification settings - Fork 12
Variables
Variables let you substitute the note's title or properties into labels, tooltips, and URIs (including links to files in your vault).

Tip
Tooltips, labels, and URIs also support the use of Dataview expressions, and Templater commands, if you need even more dynamic values in your toolbars like dates.
The following variables are supported within labels, tooltips, and URIs:
Variable | What it is |
---|---|
{{dv: ... }} |
Dataview expression (or you can use Dataview's prefix, which defaults to = ).Example: {{dv: dateformat(date(today), "MMM d")}}
|
{{file_path}} |
Path to the file, from the root of the vault. |
{{js: ... }} |
JavaScript expression. Example: {{js: return new Date().toLocaleDateString('en-US', { month: 'short', day: 'numeric' })}}
|
{{jse: ... }} |
JS Engine expression. Example: {{jse: return app.workspace.activeEditor.file.basename}}
|
{{note_title}} |
The name of the current note, without the file extension. |
{{prop_NAME}} |
Property in the current note with the given name. e.g., if you have a property called "date" use {{prop_date}} Notes: If the property does not exist, the variable will be blank. List properties become comma-separated lists. |
{{tp: ... }} |
Templater expression (or you can use Templater tags: <% and %> ).Example: {{tp: tp.date.now("MMM Do")}}
|
{{vault_path}} |
Path to the vault on your file system. |
Notes:
- If a link with variables resolves to an empty value, then the item will be hidden from the toolbar.
Let me know ↗ if you have ideas for variables you would like to see added.
If your property is called url
and url
= google.com
then:
- Setting URI to
{{prop_url}}
and then clicking on it will create a note calledgoogle.com
- To make it a link, either:
- add the protocol in the toolbar item:
https://{{prop_url}}
or - put the
https://
in the property itself: i.e.,url
=https://google.com
- add the protocol in the toolbar item:
All variables (except for scripts) support an encode:
prefix, which, if added to a variable encodes that variable using encodeURIComponent()
.
For example, here's a URI for Open in VS Code -- available in the Gallery -- using VS Code's URL handling ↗ to open the current file:
vscode://file/{{encode:vault_path}}%2F{{encode:file_path}}
Next: Positioning toolbars
User Guide • Gallery • Note Toolbar API • Support • Discussions ↗ • Release Notes ↗ • Roadmap
Note Toolbar by Chris Gurney • Buy me a coffee ☕️