Set up a changelog page

A product updates changelog turns what shipped in your repos into dated entries on a Notion page. You need at least one connected repo and one Notion destination before you can configure a page. See Getting started: connecting GitHub and Notion if you haven't connected either yet.

A changelog page is a Notion page whose document type is set to Product updates. Configure it from Pages in the dashboard.

<aside> ✏ Product updates can only be published to Notion. If a page's destination is GitHub, product updates is not an available document type for it.

</aside>

Choose source repos

A changelog page can draw from more than one repo. Each source repo contributes entries whenever it ships a change, and all of them land as dated entries under the same page.

  1. Open Pages and select the Notion page you want to use as your changelog, or add one as a destination first if none exists.
  2. Set its Type to Product updates.
  3. Under Add repo, choose a connected repo to feed this changelog.
  4. Repeat to add more repos to the same page.

The page lists every source repo feeding it. Removing a repo stops new entries from it without touching entries already drafted or published.

Set the grouping

Grouping controls how entries are organized on the page:

Grouping What it does
One page per month Entries land on a dated page covering a calendar month.
One page per week Entries land on a dated page covering a calendar week.
One page per change Each change gets its own page.
One running page All entries accumulate on a single page.

Choose the option from the Grouping setting on the changelog page's configuration. Changing grouping later affects how new entries are organized going forward; it does not retroactively move entries already published.

Set the level of detail

The Amount setting controls which changes appear in the changelog:

The daily allowance is shared by all source repos and by generated history and daily updates. Extra drafts stay in review. Set the amount alongside grouping on the same configuration panel. It applies to entries drafted after you change it.