Changelog best practices for SaaS
How often to publish, what tone to use, what NOT to include, and how to make a changelog people actually read.
Most SaaS changelogs are a graveyard. Last entry from 2024. Three bullet points that say "Bug fixes and performance improvements." Nobody reads them.
A good changelog does the opposite: it pulls customers back into the product, shows momentum to investors, and gives your support team an anchor for "we just shipped that."
Here's what we've learned running the Supoid changelog.
How often to publish
Weekly is the sweet spot. Daily is too noisy unless you're a devtool. Monthly is so far apart that customers forget the last update existed.
If you're shipping multiple things in a week, bundle them into one entry with subsections. One entry per week, even if it's small.
What to include
Always:
- New features (with a screenshot or GIF)
- Behaviour changes that affect users
- Pricing or billing changes
- Bug fixes that customers reported
Sometimes:
- Performance wins, if they're noticeable (e.g., "20% faster page loads")
- Security fixes, with restraint — don't telegraph the vulnerability you just patched
- Beta features, clearly labelled
Never:
- Internal refactors
- Dev-tooling changes
- "Misc improvements"
- Anything that would only make sense to your engineers
Tone
Write like a person, not a release-notes robot. Compare:
v2.4.0 — Added dark mode preference toggle.
vs.
Dark mode is here. Toggle it from your account settings — your eyes will thank you on midnight deploys.
The second one is harder to write but gets read. Use first person where appropriate. Make jokes when they're real. Show personality.
Linking back to feedback
Every changelog entry should ideally link to:
- The original feedback cluster — gives credit to customers who asked.
- The roadmap card — closes the loop visually.
- A demo — screenshot, GIF, or 30-second Loom.
Tools that handle this automatically (Supoid does) save the time you'd spend hunting for links.
Format
The structure that works for most B2B SaaS:
## What's new in v2.4 — March 14, 2026
### ✨ New
- **Dark mode** — toggle in Settings → Appearance.
- **Bulk export** — CSV/JSON download for all feedback.
### 🐛 Fixed
- CSV export no longer truncates Unicode in workspace names.
- Slack notifications respect quiet hours.
### 🛠 Improved
- Public board loads 40% faster on large workspaces.
[View on roadmap →](https://supoid.com/roadmap)
Three sections: , , . Skip the ones that don't apply.
Try Supoid
Free forever for solo founders. No credit card.