How to Create a Changelog in Notion
A product changelog is one of the highest-leverage artifacts a PM can maintain. Internally, it gives the team a sense of progress and provides sales and support with ammunition for customer conversations. Externally, it signals that the product is actively developed and helps users discover features they might have missed. The problem is that changelogs are usually the first thing to fall behind when the team is shipping fast.
Notion is well suited for changelogs because it can serve as both the authoring tool and the publishing mechanism. With Notion's database views, you can maintain a single source of truth that renders differently for different audiences: a detailed internal view for the team, a polished external view for users, and a filtered view by feature area for customer-facing teams. This guide sets up all three.
Step-by-step guide
Create a changelog database
Create a new Notion database (full-page, not inline) called Product Changelog. Add properties: Title (the release headline), Release Date (date), Version (text or number), Category (multi-select: New Feature, Improvement, Bug Fix, Deprecation), Feature Area (multi-select matching your product areas), Status (select: Draft, Internal Review, Published), and Audience (multi-select: Internal, External, Enterprise). Each database entry will be one changelog item, not one release.
- Create a full-page database titled Product Changelog
- Add properties: Release Date, Version, Category, Feature Area, Status, Audience
- Set default property values for Status (Draft) and Audience (Internal)
Design the changelog entry template
Create a database template that pre-fills the structure for each entry. Include sections for: a one-sentence summary (this becomes the external headline), a detailed description (2-3 paragraphs for internal use), screenshots or GIFs showing the change, a list of affected endpoints or pages, and a 'Customer Impact' section for support and sales teams. The template ensures consistency across entries regardless of who writes them.
- Create a template with summary, detailed description, visuals, and customer impact sections
- Add a callout block for breaking changes or migration steps
- Include a toggle block for technical details that are relevant for engineering but not external users
Set up views for different audiences
Create filtered views on the database. An 'External Changelog' view filters to Status: Published AND Audience: External, sorted by Release Date descending, displayed as a list with only Title, Release Date, and Category visible. An 'Internal All' view shows everything sorted by date. A 'By Feature Area' view groups entries by Feature Area. Create a 'Pending Review' view filtering to Status: Draft or Internal Review for your review workflow.
- Create External Changelog view: published + external, list layout
- Create Internal All view: all entries, sorted by date
- Create By Feature Area view: grouped by area, for customer-facing teams
- Create Pending Review view: draft entries awaiting approval
Establish the authoring and review workflow
Define who writes changelog entries and when. The most sustainable approach is to make changelog entry part of the definition of done: the PM or engineer who ships a feature writes the entry before the sprint closes. Set up a weekly review where you change Status from Draft to Internal Review, then to Published. Use Notion's mention feature to tag reviewers and the commenting system for feedback. This prevents the bottleneck of one person writing all entries.
- Add changelog entry to your team's definition of done
- Set up a weekly review cadence for changing entry status
- Use Notion mentions and comments for the review cycle
Publish and distribute the changelog
For external users, share the External Changelog view as a public Notion page. Add it to your product's help center or documentation site. For internal distribution, set up a weekly Slack digest that links to the Pending Review and recently Published entries. Consider embedding the External view in your app's settings or help section using Notion's embed feature. The goal is to reduce the friction between publishing an entry and users actually seeing it.
- Share the External Changelog view as a public page
- Add the public link to your docs site and in-app help section
- Set up a weekly Slack notification linking to new entries
Integrate with your release process
Connect the changelog to your existing release workflow. If you tag releases in GitHub, use the Notion API or a Zapier integration to auto-create draft changelog entries when a release tag is pushed. Pre-fill the version number and date from the tag. If you use Linear or Jira, create a relation property linking changelog entries to the tickets they describe. This creates a traceable chain from ticket to ship to communication.
Common mistakes
Writing changelogs in developer language
Entries like 'Refactored the authentication middleware to use JWT refresh tokens' mean nothing to users. Translate every entry into user impact: 'You will no longer be logged out unexpectedly during long sessions.' Keep technical details in a toggle block for the internal audience.
Batching too many changes into one entry
A single entry with 15 bullet points is not a changelog, it is a release manifest. Each meaningful change should be its own entry with its own headline, description, and visuals. Users scan changelogs; they do not read them. Give each change room to be discovered.
Letting the changelog go stale
A changelog that has not been updated in 3 months signals abandonment, not stability. Making entry creation part of the definition of done and having a weekly review cadence prevents staleness. Even a week with only bug fixes should have entries — it shows the team cares about quality.
Tips
Use Notion's gallery view for the external changelog with the screenshot property as the card preview to make the page visually engaging
Add a 'Subscribe' callout at the top of the external changelog with a link to your product updates email list
Tag changelog entries with the customer who requested the feature so sales and CS teams can do personalized outreach when it ships
Create a 'Quarterly Highlights' rollup page that summarizes the most important entries from the past quarter for executive updates
How Vantage helps
Vantage tracks what you ship by syncing with your ticketing system, so it can auto-suggest changelog entries based on completed tickets. When a ticket is resolved and synced back, Vantage surfaces the change in user-facing language, ready for you to review and publish. This closes the gap between shipping and communicating without adding another manual step to your workflow.