silverbullet/website/Live Template Widgets.md

Live Template Widgets allow you to automatically render templated markdown widgets at the top or bottom of pages matching specific criteria.

Warning

Warning This feature is still experimental, aspects of it may change, or it could be removed altogether.

Defining

Live Template Widgets are regular Templates that set a hooks.top or hooks.bottom attribute (depending on where you would like them to appear), specifying:

• where: should contain an Live Queries$expression that evaluates to true for the pages you would like to apply this template to, usually this checks for a specific tag, but it can be any expression. Think of this as a where clause that should match for the pages this template is applied to.
• order (optional): in case you have multiple templates that have matching where expression, the one with the priority set to the lowest number wins.

Example

The following widget template applies to all pages tagged with person (see the where). It uses the Library/Core/Widget/Linked Tasks template to show all incomplete tasks that contain a link to the current page.

---
tags: template
hooks.top.where: 'tags = "person"'
---
## Incoming tasks
```template
page: "[[!silverbullet.md/Library/Core/Widget/Linked Tasks]]"
```

More examples can be found Library/Core/Page/Template Index$widgets.