How to Create a Product Changelog in Notion
A product changelog is one of the highest-ROI artifacts a PM can maintain. It closes the loop with customers who requested features, gives sales a "what's new" reference, and forces the team to ship with intent rather than in stealth. Notion's database system makes it easy to maintain one changelog that serves both internal and external audiences.
This guide covers how to build a structured changelog in Notion, from database setup to writing conventions that make entries worth reading.
Step-by-step guide
Create a Changelog database
Create a full-page database called "Product Changelog." Add properties: Version (text, e.g., "v2.4"), Release Date (date), Type (select: New Feature / Improvement / Bug Fix / Deprecation), Audience (select: Internal / External / Both), Author (person), Status (Draft / Ready / Published), and Tags (multi-select for feature areas).
Set up database views
Create three views: a Table view for the PM to manage drafts, a Gallery view for a visual public-facing changelog, and a Board view grouped by Status for the publishing workflow. Filter the Gallery view to show only "Published" entries with Audience = External or Both.
Write entries with user-centric language
Each changelog entry should start with the user benefit, not the technical change. Bad: "Refactored the search indexing pipeline." Good: "Search results now appear 2x faster." Lead with what changed for the user. Add technical detail in a collapsed toggle for internal readers.
Link to context and tickets
Add a Relation property connecting changelog entries to your PRDs database and your Linear or Jira tickets. This creates traceability: from the changelog entry back to the PRD that defined the feature and the tickets that shipped it. Engineers can also link their tickets to upcoming changelog entries.
Publish to Notion Sites or export
For an external-facing changelog, publish the filtered Gallery view using Notion Sites (Settings > Sites). Share the public URL with customers and embed it on your product website. For teams using a separate public site, export changelog entries via the Notion API and populate your website's changelog page.
Common mistakes
Writing changelogs after the fact
Changelogs written weeks after a release are inaccurate and incomplete. Create a draft changelog entry when a feature enters development, not after it ships. Engineers can add technical context; PMs add the user-facing summary at launch.
Technical language in external changelogs
External changelogs are marketing, not engineering docs. Write for your least technical customer. "Improved database query performance" means nothing to a user. "Your dashboard now loads in under 1 second" means something.
One changelog for all audiences
A changelog entry about deprecating a legacy API endpoint is relevant to developers, not end users. Use the Audience property to separate internal-only entries from external ones. Publish only what is relevant to each audience.
Tips
Send a Slack message to #product-announcements linking each new changelog entry on the day of publish
Use the Tags property to let customers subscribe to changelog entries for specific feature areas
Add a monthly "What shipped this month" summary entry that rolls up individual entries for leadership
How Vantage helps
Vantage tracks the full lifecycle from PRD to shipped ticket. When a feature ships, the PRD, requirements, and ticket history are already connected in Vantage. Use the Vantage context to write accurate changelog entries that reference the original user problem and the solution that shipped.