> ## Documentation Index
> Fetch the complete documentation index at: https://onset.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> How release notes work in Onset, from draft to published.

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

| State | What it means |
| - | - |
| **Draft** | Only visible to your team. Not on the public page, not in feeds. |
| **Scheduled** | Written and queued to publish automatically at a set date and time. |
| **Released** | Live on your public page, in your feeds, and in the widget. |

## Where a published release shows up

* Your **public page** (`yourslug.onset.io` or your [custom domain](https://onset.io/docs/page/custom-domains.md))
* Your **RSS, Atom, and JSON [feeds](https://onset.io/docs/guides/page/feeds.md)**
* The in-app **[widget](https://onset.io/docs/developers/widget/overview.md)**, if installed
* **Email**, **Slack**, and **Discord**, if you enable those notifications when publishing

## Anatomy of a release

> [accordion] Title and permalink
>
> The title is what customers see first. Onset generates a permalink from it,
> which you can edit under **Permalink**. Worth setting deliberately if you
> plan to link to the release from elsewhere.

> [accordion] Body
>
> The main content. Supports rich text, Markdown, images, and media embeds.
> See [Writing releases](https://onset.io/docs/guides/releases/writing.md).

> [accordion] Change list
>
> 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](https://onset.io/docs/guides/releases/writing.md).

> [accordion] Version
>
> An optional version number and pre-release flag. See
> [Versioning](https://onset.io/docs/guides/releases/versioning.md).

> [accordion] Contributors
>
> Workspace members to credit on the release. See
> [Contributors](https://onset.io/docs/guides/releases/contributors.md).

> [accordion] Projects and labels
>
> Used to organize and filter releases. See [Projects](https://onset.io/docs/guides/projects.md) and
> [Labels](https://onset.io/docs/guides/labels.md).

> [accordion] Attachments and related items
>
> Files and links related to this release.

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.