---
url: https://releasenotifier.beyondthecloud.dev/docs/releases.md
description: The guided release editor, versioning, re-acknowledgment and cloning.
---

# Create and publish releases

You need the **Release Notifier Content Creator** permission set or higher.

## The guided editor

From **What's New**, create a release. The editor walks you through five steps, each with a **Mark as Ready** action:

1. **Release** - name, description, dates and whether acknowledgment is required.
2. **Categories** - the folder structure of the release. Categories nest, and you can start from a [category template](/docs/audiences#templates).
3. **Release Notes** - the content, written per note with rich text and images.
4. **Audiences** - who sees the release. Required before publishing; see [Audience targeting](/docs/audiences).
5. **Translations** - optional content in other languages; see [Translations](/docs/translations).

![Release editor overview](/images/release-editor-overview.png)

Publish when every required step is ready. The release appears in the What's New feed of every targeted user.

## Editing a published release

When you edit an active release that requires acknowledgment, Release Notifier creates a new version automatically. Acknowledgments carry over for notes whose content did not change; users are asked to re-acknowledge only the notes you actually changed. Content comparison is hash-based, so formatting-only edits of unrelated notes do not reset anyone's status.

## Cloning

**Clone Release** copies an existing release and lets you choose whether to include categories, release notes and translations. Use it for recurring release shapes, for example a monthly sprint review.

![Release editor with release notes](/images/release-editor-release-notes-1.png)