This article is part of the series Using Techly.

Use pinning when an announcement or evergreen article should stay visible above newer posts — without backdating it or bumping the publish date.

Pin a post

Add pinned at the top level of the post’s front matter:

+++
title = 'Important announcement'
date = 2026-05-22T15:00:00+02:00
pinned = true
+++

Pinned posts are sorted to the top of the home page and the Posts section listing (/posts/). Among pinned posts, the usual date order still applies — newest first.

Show the pin indicator

To display the pin icon beside the date on listing cards, add pinnedIndicator alongside pinned:

+++
title = 'Important announcement'
date = 2026-05-22T15:00:00+02:00
pinned = true
pinnedIndicator = true
+++

The icon uses your theme accent color. A post can be pinned without the indicator — useful when you want top placement without drawing extra attention.

When to use it

Pinning works well for:

  • Status updates or “work in progress” notices
  • A getting-started guide you always want easy to find
  • A post you link to often from elsewhere

Use it sparingly. If everything is pinned, nothing stands out.

Try it here

See the under development post on the posts listing for a live example with the pin indicator.

Tags