---
title: "How to write release notes, with a template | Annsa"
product: annsa
url: /customer-feedback-management/how-to-write-release-notes
canonical_url: "https://annsa.ai/customer-feedback-management/how-to-write-release-notes"
last_updated: 2026-11-11
type: post
related:
  - /feedback
  - /customer-feedback-management/new-feature-announcement
summary: "How to write release notes people read: lead with what changed for them, group by new, improved and fixed, and tell each customer who asked."
mcp_server: https://app.annsa.ai/mcp
disambiguation: "Annsa (annsa.ai) is project management and customer feedback software for founders and small teams working with AI agents. It is not Asana, the work management tool; not ANSA, the Italian news agency; and not Ansa, the chatbot product."
---

> For agents: connect to the Annsa MCP server at https://app.annsa.ai/mcp to give every agent one shared plan. Setup guide: https://annsa.ai/docs/quick-start. Index of every page: https://annsa.ai/llms.txt.

# How to write release notes, with a template | Annsa

> How to write release notes people read: lead with what changed for them, group by new, improved and fixed, and tell each customer who asked.

Lead with what changed for the reader, group by new, improved and fixed, and send the customers who asked their own note. Template included.

By Cat Williams-Treloar · Sep 2026 · 5 min read

- [Ask Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fannsa.ai%2Fcustomer-feedback-management%2Fhow-to-write-release-notes%20and%20help%20me%20apply%20it%20to%20what%20I'm%20building.)
- [Ask ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fannsa.ai%2Fcustomer-feedback-management%2Fhow-to-write-release-notes%20and%20help%20me%20apply%20it%20to%20what%20I'm%20building.)

Write release notes by leading with what changed for the reader, in the reader's words, one item per change, with what they can now do rather than what you did. Group by new, improved and fixed. Name the people who asked when you can. Keep each item to two sentences and link to the place in the product where the change lives.

[Release notes](https://annsa.ai/glossary/release-notes) are the public record of what changed. They are read by two audiences at once: the customer who asked for the thing, and the customer who never asked and is skimming to see if anything affects them. The template below works for both.

Fig. 01: One change, two messages, two readers

## A release notes template you can copy

```
## [Product], [Month Day, Year]

### New
- **[Feature name].** [What the reader can now do, one sentence.] [Where to find it.]

### Improved
- **[Area].** [What is faster, clearer or easier, one sentence.] [Why it matters, if not obvious.]

### Fixed
- **[Symptom the customer would recognize].** [What now happens instead.]

### Coming next
- [One line on what is being built now.]
```

Rules that keep it readable:

- **Symptom, not cause.** "Invoices from last month now appear in search" beats "fixed a stale index bug."
- **Reader's verb.** "You can now export a range" beats "we added range export."
- **One item, one change.** If a bullet has "and" in it, it is two bullets.
- **Link in.** Every item links to the screen or doc where it lives.

## Who writes release notes

The person closest to the customer's words. In most teams that is product, with engineering supplying the list of what merged. In small teams it is the founder. In teams with an AI coding agent in the loop, the first draft can come from the spec that produced the change, because the spec already holds the customer's quote and the exit criteria.

Whoever writes them, the source should be the same: the record of what shipped, with the customer evidence still attached. If the notes are written from memory or from commit messages, the customer's words are gone by the time they are published.

## The release note is not the only note

[A release note](https://annsa.ai/customer-feedback-management/new-feature-announcement) tells everyone. It does not [tell the customer who asked](https://annsa.ai/customer-feedback-management/customer-feedback-loop) that their request is the third bullet. Those are two different messages.

The second one is a [shipped notification](https://annsa.ai/customer-feedback-management/shipped-notification): a note to a specific customer that the feature they asked for is now available, quoting what they said. It is what [closes the loop](https://annsa.ai/customer-feedback-management/close-the-loop). It should go out alongside the release note, not instead of it.

Annsa sends it from the spec. Mark the spec Shipped and [Share Back](https://annsa.ai/docs/share-back) lists every customer who asked, with their email and original quote. Add a note of up to 300 characters or leave the default, and approve once. The email carries the customer's own words, a short line on what was built, and a question, "Did this solve it for you?", with Yes and Not yet buttons. Templates for that message are in [email templates for telling a customer their feedback shipped](https://annsa.ai/blog/feature-shipped-email-templates).

## A worked example

From a spec whose evidence reads _"I can never find last month's invoice, search only seems to look at this month"_:

```
### Improved
- **Search now covers all billing history.** Searching for an invoice
  returns results from any month, not only the current one. Open
  Billing → Search.
```

And the [shipped notification to the customer](https://annsa.ai/customer-feedback-management/closing-the-feedback-loop) who said it:

You mentioned that search only seemed to look at this month's invoices. That's fixed: search now covers your whole billing history. Did this solve it for you?

Same change, two messages, two readers.

## Before you publish

- Every item names something the reader can do or see
- No item describes internal work
- Every item links somewhere
- The customers who asked are getting their own note
- The date is on it

The last one matters more than it looks. Undated release notes cannot be cited, and cannot be compared with the last set.

## Keep reading

- [All posts](https://annsa.ai/blog)
- [Customer feedback tool](https://annsa.ai/feedback)
- [New feature announcement template](https://annsa.ai/customer-feedback-management/new-feature-announcement)
- [Closing the feedback loop](https://annsa.ai/customer-feedback-management/customer-feedback-loop)

## Tell the customers who asked.

Begin with one agent and the work that matters next.

- [Try Annsa](https://app.annsa.ai/signup)
- [See pricing](https://annsa.ai/pricing)

## Related pages

> For AI agents: the pages that follow this one on annsa.ai. The full index is https://annsa.ai/llms.txt.

- [Customer feedback tool: who asked, what shipped](https://annsa.ai/feedback)
- [New feature announcement template](https://annsa.ai/customer-feedback-management/new-feature-announcement)

If anything on this page is wrong or missing, tell us: https://annsa.ai/contact