Changelogs are the most underappreciated piece of product communication. Users actually read them. Here's how to use AI to write changelogs that don't suck.
The problem with most changelogs
Most changelogs look like this:
v2.3.1
- Fixed bug
- Updated dependencies
- Minor improvements
That tells users nothing. "Fixed bug" — which bug? Does it affect me? "Minor improvements" — what improved?
The changelog prompt
Write a changelog entry for version [VERSION].
Changes: [PASTE RAW CHANGES / COMMIT MESSAGES / PR DESCRIPTIONS]
Format:
- Group by: ✨ New / 🔧 Improved / 🐛 Fixed
- Each entry: one sentence, starts with a verb
- Translate technical jargon to user-facing language
- Flag breaking changes explicitly
- Include migration notes if needed
Rules:
- No "minor improvements" — be specific or omit
- No "various bug fixes" — list them or group as "stability improvements"
- If a change doesn't affect users, don't include it
Example output
Raw input:
- Refactored auth service to use JWT
- Fixed race condition in websocket reconnection
- Added dark mode toggle in settings
- Updated React from 17 to 18
- Fixed typo on pricing page
AI output:
v3.2.0
✨ New
- Dark mode is here. Toggle it in Settings.
🔧 Improved
- Authentication is now faster and more secure (JWT-based)
- Upgraded to React 18 for better performance
🐛 Fixed
- WebSocket connections no longer drop during network switches
- Corrected pricing display on the Pro tier
Notice: the React upgrade is translated to user-facing benefit. The typo fix is included because it's specific. The race condition fix is explained in plain language.
The follow-up prompt
Based on this changelog, write:
1. A tweet announcing the biggest change (under 280 chars)
2. An in-app notification (under 50 words)
3. A Discord/Slack announcement (casual tone, under 100 words)
This turns one changelog into multi-channel communication.
The full prompt collection includes changelog prompts, release notes prompts, and 200+ more for every part of running a product.
$9 launch pack: https://innovate01.gumroad.com/l/qevvy
Top comments (0)