Skip to main content
A release is a single update you publish to your customers. Each one has a title, a body, and optional extras like a version number, labels, contributors, and a change list.

Release states

Where a published release shows up

  • Your public page (yourslug.onset.io or your custom domain)
  • Your RSS, Atom, and JSON feeds
  • The in-app widget, if installed
  • Email, Slack, and Discord, if you enable those notifications when publishing

Anatomy of a release

The main content. Supports rich text, Markdown, images, and media embeds. See Writing releases.
A structured list of individual changes, each tagged with a change type like New, Fixed, or Security. Good for long releases where the body is a summary and the change list carries the detail. Change types are customizable; see Writing releases.
An optional version number and pre-release flag. See Versioning.
Workspace members to credit on the release. See Contributors.
Used to organize and filter releases. See Projects and Labels.

Publishing settings for the whole page

Some options are page-wide rather than per-release. Under Settings → Page → Releases you can turn the releases section on or off, choose the default view, and toggle whether contributors, reactions, and AI summaries are shown.