Skip to content
Scrollback
Go back
Deep Dive

How topics, categories and tags fit together

Scrollback gives each post three labels. They do different jobs, so it helps to keep them separate.

Category: the subject

A post has one category. It decides which topic card the post appears under on the home page. Keep the list short, five to eight is plenty. Posts without a category still work, they just don’t get a topic card.

Post type: the format

The post type is the kind of post, such as a quick note or a long guide. It shows as a coloured badge on cards and on the post itself. The colours are set in astro-paper.config.ts.

Tags: the detail

Tags are free-form and can be as specific as you like. They power the tag pages and help search. A post can have as many as it needs.

Using tags for topics instead

If you would rather build the topic cards from tags, change one line in astro-paper.config.ts:

topics: {
  source: "tags",
}

With lots of tags the home page gets busy, so use minPosts to hide topics that only have one post.


Share this post:

Previous Post
Writing your first post
Next Post
Customising Scrollback