silverbullet/website/Page Decorations.md

---
pageDecoration.prefix: "🎄 "
---
Page decorations allow you to “decorate” pages in various ways.

For now “various ways” means just one way (adding a visual prefix), but in the future, more such decorations will likely be added.

There are two ways to decorate a page.

# Frontmatter
The first is demonstrated in the [[Frontmatter]] of this page, by using the special `pageDecoration` attribute.

# Settings
The more useful way is to apply decorations to pages _dynamically_, you can use the `pageDecorations` attribute in [[SETTINGS]].

Every page decoration has two parts:
* `where`: the [[Expression Language]] expression that has to evaluate to `true` for a given page for that decoration to be applied.
* A set of decorations to apply, see [[#Supported decorations]]

For example:
```yaml
pageDecorations:
- where: "tags = 'person'"
  prefix: "🧑 "
```

This will prefix all pages tagged with `#person` with a 🧑 emoji.

Here on silverbullet.md, we have a decoration like this for pages tagged with #plug: [[Plugs/Emoji]] and [[Plugs/Git]] for instance.

# Supported decorations

* `prefix`: A (visual) string prefix (often an emoji) to add to all page names. This prefix will appear in the top bar as well as in (live preview) links to this page. For example, the name of this page is actually “Page Decorations”, but when you link to it, you’ll see it’s prefixed with a 🎄: [[Page Decorations]]
* `hide` When this is set to `true`, the page will not be shown in [[Page Picker]], [[Meta Picker]], or suggested for completion of [[Links]]. It will otherwise behave as normal - will be [[Plugs/Index|indexed]] and found in [[Live Queries]]. The page can be opened through [[All Pages Picker]], or linked normally when the full name is typed out without completion.

Later, more such decorations may be added.