Templates

Tags and tag pages

Tags group pages across a folder. List a page’s tags, filter any list by one, and let Verso make a page for every tag.

Any page can have tags. Set them in Page settings; they are kept in page.json:

{
  "template": "post",
  "title": "Spring menu",
  "date": "2026-04-02",
  "tags": ["Seasonal", "Menus"],
  "fields": { "headline": "Spring menu" }
}

A tag's address is made from its name: lowercase, with anything but letters and numbers turned into dashes, so “Design Systems” is design-systems. Two spellings that make the same address count as one tag.

Showing a page's tags

{{ each:tags }} lists this page's tags; inside a list, {{ each:item.tags }} lists each item's. Each tag gives {{ item.title }}, its name, and {{ item.url }}, the address of its tag page, when the site has one:

<ul class="row gap:d2">
  {{ each:tags }}
  <li><a href="{{ item.url }}" class="font:small">{{ item.title }}</a></li>
  {{ /each }}
</ul>

{{ page.tags }} writes them out as one line, separated by commas.

Listing pages by tag

tagged- filters any list of pages, using the tag's address: {{ each:journal:tagged-design:6 }}. It works on counts too: {{ count:journal:tagged-design }}.

Tag pages

To give a folder's tags pages of their own, make a page and add "tags-of" to its page.json, naming the folder whose tags it holds:

{
  "template": "topics",
  "title": "Topics",
  "tags-of": "journal",
  "fields": {}
}

Put it at content/topics/, and it becomes /topics/, the list of every tag. Verso also makes a page for each tag used in content/journal/, beneath it: /topics/design/, /topics/process/. Every one uses the same template and the same blocks. In it:

WriteShows
{{ page.tag }}The tag this page is for. Empty on the list of tags itself
{{ each:tagged }}The pages with this page's tag. On the list of tags, every page in the folder
{{ each:all-tags }}Every tag in the folder, with {{ item.count }}. Sort with a-z (the default) or most

So one template serves both:

<h1>{{ if:page.tag }}Posts about {{ page.tag }}{{ else }}Topics{{ /if }}</h1>
{{ if:page.tag }}
  {{ each:tagged }}<a href="{{ item.url }}">{{ item.title }}</a>{{ /each }}
{{ else }}
  {{ each:all-tags:most }}<a href="{{ item.url }}">{{ item.title }} ({{ item.count }})</a>{{ /each }}
{{ /if }}

A tag page's title is the tag and the list's label, like “Design — Topics”. Tag pages are built and listed in the sitemap like any page, and only tags from live pages make one. A list of tagged pages can be split into pages too.

On a page without "tags-of", {{ each:all-tags }} lists every tag on the site, and each tag's address points to the tag page whose folder holds it.

A tags page can sit inside the folder it lists, like content/journal/topics/. Lists of that folder's pages leave it out, but the editor warns you, because the folder's feed and the Channels panel still count it as a post. Beside the folder is simpler, as the starter does with content/topics/.

In the editor

You don't need to write "tags-of" by hand. Open a page's Page settings, open Advanced, and choose a folder under Make this a tag page, listing the tags of. If the page has a block area and the site has blocks that list tags, Verso offers to add them: in a new site, Tag list, which shows every tag with its count, and Tagged posts, which shows the posts with this page's tag. Press Add them and they go at the end of the page's first block area.

Open a tag page, like /topics/design/, and you see it with the editor of the page it comes from, so any change you make there lands on the list of tags.