The full guide
Last verified 2026-10-30
Links checked 2026-10-30 · No website to check: this channel works by word of mouth or offline
01What it is and who is there
A public changelog lists what you shipped and when. A public roadmap shows what you plan next. Together they give you a steady reason to post, email and relaunch, and they show visitors the product is alive. The audience is mostly existing users and people evaluating you.
02Cost and what you actually pay for
A changelog can be a simple page on your site. Dedicated changelog and roadmap tools exist with free and paid plans; check current pricing. The cost is the time to write clear updates.
03Is it right for you?
It fits products that ship often, such as SaaS, developer tools and apps. It fits poorly for products that rarely change. If you ship monthly or more, it is cheap and useful.
04Before you start
- A changelog page on your site, linked from the footer and the app.
- A simple format for each entry: date, what changed, why it matters.
- Optional: a public roadmap with what you are considering.
05Step-by-step: how to distribute here
- Write a changelog entry for every meaningful release.
- Lead each entry with the user benefit, then the details.
- Share the entry as a post on X, LinkedIn or your community.
- Bundle a month of entries into a newsletter update.
- Let users vote on the roadmap, and tell voters when their request ships.
- For big releases, relaunch on boards that allow it.
06What to post or submit
Changelog entry:
[Date] — [Feature name]
You can now [do X]. Before, you had to [old way]. [Screenshot or GIF]. Thanks to [user or community] for asking.Social post:
New in [product]: [feature]. [One-line benefit]. [GIF] [link to changelog]07Common mistakes and do-nots
- Do not write entries only in technical jargon.
- Do not promise roadmap dates you cannot keep.
- Do not let the changelog go stale.
08How to measure it
- Track views of the changelog page.
- Track feature adoption after each announcement.
- A realistic test: three months of regular entries.
09Time budget
- Per entry: 15 to 30 minutes.
- Monthly roundup: 1 hour.
10Pair it with
- Relaunch on every big release — big entries become launches.
- Your own newsletter — monthly roundups.
- Build in public on X — post each release.
- Run your own community — share updates first with members.
11Sources
- No external source. Practice-based guide.