Changelog Publish your changelog from Notion

A changelog tells customers what changed in your product and when. If your team plans releases in Notion, the changelog can live there too, and your website shows the latest version.

Set up the changelog database

Create a Notion database for release notes. A setup that works well:

  • Title: what changed, written for customers (“You can now export invoices as PDF”).
  • Date: when it shipped.
  • Type: a select with New, Improved and Fixed.
  • Page content: optional details, screenshots or a short video for bigger changes.

Choose how it looks

Create a view sorted by Date, newest first, and put it on a page called something like “What's new”. A list view reads like a classic changelog, a gallery view works well with screenshots.

The embed shows the view the way you set it up in Notion, including its sorting and filters. To hide internal entries, add a Published checkbox and filter the view on it.

Where to show it

  • A What's new page on your website.
  • Inside your app, for example behind a “What's new” link in the help menu.
  • Your docs or help center, next to the articles it relates to.

Put it on your website in 3 steps

  1. Share the page from Notion. Open the page in Notion, click Share, turn on Share to web and copy the link.
  2. Add it to NotionHero. Paste the link into NotionHero and pick the look: cover image, dark mode, or your own CSS on the Heroic plan.
  3. Paste the embed code into your site. Copy the snippet into WordPress, Webflow, Wix, Squarespace, Ghost or your own app. It resizes to fit the page.

The embed code looks like this:

<iframe src="https://e.notionhero.io/e1/p/your-page"
  width="100%" height="600" style="border:0" data-notionhero-autoheight></iframe>
<script async src="https://e.notionhero.io/embed.js"></script>

Publish your changelog

Free for up to 3 embeds. No credit card needed.

Frequently asked questions

Does the changelog update when I add an entry in Notion?

Free embeds refresh from Notion every 3 days. On the Heroic plan they refresh every hour, and you can refresh by hand right after you publish a change.

Can each entry have its own page?

Yes. Every database entry is a Notion page, and visitors can open it inside the embed to read the details.

Can I show only some entries?

Yes. Filter the view in Notion, for example on a Published checkbox. The embed shows what the view shows.

Is it free?

Your first 3 embeds are free, with a small NotionHero badge. Heroic removes the limit and the badge.

More ways to use NotionHero