Skip to main content

Posts & Content

A Post is a single piece of content you publish to two channels — the web and email — independently or together.

What a post is​

  • Web — a page on your site at /<content_path>/<slug>, defaulting to /content/<slug>.
  • Email — sent to a newsletter list, if one is selected.

A post can be web-only, email-only, or both. Every published post has a web page; email is opt-in per post via a newsletter list.

The content archive​

Published posts with Listed visibility appear in your site's content index (newest first), at /content by default or your configured content path. The archive also gets an RSS feed and sitemap entries, Listed posts only.

Unlisted posts still get a page and URL — they're just not in the index, RSS feed, or sitemap. Use Unlisted for content you want linkable but not browsable (e.g. something you're only sharing directly).

If /content (or your custom path) collides with a page you've already built at that URL, your page wins and the archive doesn't mount there.

Lifecycle​

A new post is a draft: saved, but not on the site and not emailed. Nothing happens until you publish.

Publishing puts the post live on the web and, if a newsletter list is set, sends the email to that list.

Once a post is published, editing its content and saving goes live immediately — no separate publish step for content edits.

Unpublishing takes the page down (it 404s) and returns the post to draft. The post itself isn't deleted, and you can publish it again later.

Re-publishing an already-published post re-sends the email to the list, and re-snapshots the recipient list — which resets that post's click-through stats (see below).

Slugs​

Each post has a slug, unique per project, that determines its URL (/<content_path>/<slug>). It's auto-derived from the title and can be overridden.

Emailed posts include a "view this post on the web" link back to the published page. If you Unpublish a post after emailing it, that link in already-sent emails will 404 — this is expected, not a bug.

Click tracking​

Emailed posts track link clicks: an overall click-through rate, unique clickers, and a per-link breakdown. Because re-publishing re-snapshots the recipient list, it also resets the post's click stats. Open-rate tracking is not part of this report.

Authoring​

Two ways to write and manage posts:

  • The web editor — see Posts (App).
  • The CLI, authoring posts as posts/*.md files with YAML front-matter — see Posts (CLI).

Newsletter lists themselves come from forms with the Newsletter option enabled — see Newsletter.