<aside>

đź’ˇ Follow this link for a full guide on Notion/GitHub Integration features, otherwise see below for examples of some of the key integration features between Notion and GitHub.

Integrate GitHub – Notion Help Center

</aside>

Supported GitHub Properties in Notion

Title Assignees
Description State
PR or Issue number Creator
Created time Merged, updated, and closed time
Reviewers

Create a Synced Database

To create a Database linked to GitHub, simply copy a link from the PR or issues page in the repo you want to copy, and select paste as database in a Notion page. If you haven’t authenticated the GitHub integration yet, you will be prompted to sign in. Otherwise, Notion will create a database using the below properties automatically, which you can use to track and update issues and PRs in Notion and GitHub. See below for an example of the default structure.

The database will begin populating automatically and will continue to sync if you navigate away from the page.

hbtucker/Notion-Structure Issues

Automate task status updates

You can use the GitHub Pull Requests property to automatically update the status of your tasks in Notion.

  1. Select the title of your GitHub Pull Requests property and click Edit property.

  2. Find the Auto-update section and select the status property you want to update from the drop down menu.

  3. Select the task status to be set when the GitHub PR is Opened, Review Requested, Approved, and Merged.

  4. Now when the PR progresses in GitHub, your task status in Notion will be updated automatically based on your settings.

  5. Select the title of your GitHub Pull Requests property and click Edit property.

  6. Find the Auto-update section and select the status property you want to update from the drop down menu.

  7. Select the task status to be set when the GitHub PR is Opened, Review Requested, Approved, and Merged.

  8. Now when the PR progresses in GitHub, your task status in Notion will be updated automatically based on your settings.

You can also show GitHub activity in the linked Notion task. To do this, click on the GitHub property in your database → Edit property. Turn on Activity Comments.

See the [FET - 5] task as an example: Example PR Integration

image.png

Code Previews

You can also paste lines in git or a full file as a preview in Notion by copying and pasting the permalink as a preview. You can also link from a specific commit or branch if you want the code you’re referencing to be up-to-date.

https://github.com/hbtucker/Notion-Structure/blob/main/index.html

People properties

You can use identity mapping to connect GitHub identities to your team's Notion profiles. To do this: