GitHub koppelen aan Notion
Houd Pull Requests naast de projectplannen van je team in Notion.
Een beheerde GitHub-synchronisatie maakt een GitHub Pull Requests-database van repositories die je kiest. Notion importeert bestaande Pull Requests en controleert op de achtergrond of er updates zijn in GitHub.
Deze handleiding behandelt Databasesynchronisatie in je GitHub-verbindingsinstellingen. Gesynchroniseerde eigenschappen zijn alleen-lezen. Breng wijzigingen aan in Pull Requests in GitHub.
Opmerking: Deze GitHub-integratie vervangt onze verouderde versie. Om je externe gegevens actueel te houden, stelt u je nieuwe syncs in vóór 30 oktober 2026. Je bestaande gesynchroniseerde database blijft in Notion staan, maar deze stopt met bijwerken na die datum.
Je kunt Pull Requests synchroniseren vanuit meerdere repositories die beschikbaar zijn via een GitHub App-installatie. De geselecteerde repositories feeden in één Notion-database.
Informatie | Eigenschappen |
|---|---|
Pull Request | Titel, PR-nummer, GitHub-URL, Repository |
Staat | Status: Open, Concept, Gemerged of Gesloten |
Auteur | Auteur (GitHub), en Auteur wanneer een overeenkomend Notion-lid kan worden gevonden |
Organisatie | Labels, Base Branch, Head Branch |
Datums | Aangemaakt op, Bijgewerkt op, Gesloten op, Gemerged op |
De Auteur (GitHub)-eigenschap bevat de GitHub-gebruikersnaam. Auteur is een Notion-persoonseigenschap wanneer het beschikbare openbare e-mailadres van de auteur overeenkomt met een werkruimtelid.
De Beschrijving-eigenschap synchroniseert de beschrijving van de Pull Request als tekst, exact gekopieerd zoals geschreven in GitHub. Deze wordt niet gerenderd als Markdown.
Deze synchronisatie bevat geen GitHub-issues, opmerkingen, toegewezen personen of beoordelingsdetails.
Je hebt het volgende nodig:
Lidmaatschap van de Notion workspace.
Een GitHub-account met toegang tot de repositories die je wilt synchroniseren.
Een GitHub App-installatie met toegang tot die repositories.
Een Business-abonnement (Mobile Business komt ook in aanmerking). GitHub-synchronisatie is niet beschikbaar in andere abonnementen.
Zowel je GitHub-account als de app-installatie hebben toegang nodig. Je GitHub-organisatie vereist mogelijk dat een eigenaar de app goedkeurt of installeert.
Ga in Notion naar Settings → koppelingen → GitHub.
Open Database sync en koppel je GitHub-account als je dat nog niet hebt gedaan.
Voltooi de autorisatie- en installatiestappen van GitHub.
Kies de organisatie of het account waarvan je de repositories wilt synchroniseren. Gebruik Add organization… als je een andere installatie wilt toevoegen.
Selecteer de repositories die je wilt opnemen.
Kies alle beschikbare geschiedenis of een geschiedenisvenster.
Selecteer Synchronisatie maken.
Notion maakt GitHub Pull Requests aan in je Privé zijbalksectie en begint met het importeren van overeenkomende pull requests.
Tip: Ontbreekt er een repository? Gebruik Manage access on GitHub om te controleren tot welke repositories de app toegang heeft. Als voor de installatie goedkeuring vereist is, vraag dan een eigenaar van de GitHub-organisatie om deze goed te keuren.
Tijdens de eerste import leest Notion pull requests uit elke geselecteerde repository, beginnend met de meest recent bijgewerkte records en werkend door de geselecteerde geschiedenis.
Na de import controleert Notion regelmatig elke repository op nieuwe en bijgewerkte pull requests. Wijzigingen zoals een nieuw label, een gesloten pull request of een merge werken de bijbehorende eigenschappen in Notion bij.
De synchronisatie loopt door, zelfs als je Notion afsluit. Grote repositories, GitHub-verzoeklimieten en tijdelijke serviceproblemen kunnen updates vertragen. Controleer de status van de synchronisatie voor voortgang of fouten.
Kies All history, Last 30 days, Last 90 days of Last 365 days. Wanneer synchronisatie van alle geschiedenis als schakelaar wordt aangeboden, laat Sync all available history dan aanstaan om alle beschikbare pull requests op te nemen.
Het venster gebruikt de Updated At-tijd van de pull request. Het is niet afhankelijk van wanneer de pull request is aangemaakt of of deze open, gesloten of Gemerged is.
Een open Pull Request die bijvoorbeeld al meer dan 90 dagen niet is gewijzigd, kan buiten een venster van 90 dagen vallen.
Tip: Oudere pagina's kunnen worden verwijderd. Wanneer een Pull Request buiten het geselecteerde venster valt, wordt de pagina verwijderd uit de gesynchroniseerde database, inclusief waarden in je eigen Notion-eigenschappen. Gebruik alle beschikbare geschiedenis als je ongewijzigde Pull Requests wilt behouden.
Open de synchronisatie in Settings → koppelingen → GitHub → Database sync.
Add repositories: Bewerk de selectie en selecteer Save changes. Notion importeert overeenkomende pull requests uit de toegevoegde repositories.
Remove repositories: Deselecteer ze en sla op. Hun gesynchroniseerde pull request-pagina's worden uit Notion verwijderd.
Wijzigingsgeschiedenis: Een langer venster importeert extra records. Een korter venster verwijdert records buiten het nieuwe venster.
Updates pauze: Selecteer Pauze synchronisatie. De bestaande gegevens en instellingen blijven behouden.
Updates hervatten: Selecteer Synchronisatie hervatten om door te gaan met synchroniseren.
Voordat je repositories verwijdert of de geschiedenis verkort, moet je alle informatie die alleen in Notion staat en die je nodig hebt, veiligstellen vanaf de betreffende pagina's.
Maak weergaven op basis van repository, status, auteur of label. Voeg je eigen eigenschappen toe om de releasegereedheid bij te houden of koppel Pull Requests met het planningsproces van je team. Je eigen eigenschapswaarden blijven in Notion.
Om een GitHub-eigenschap te wijzigen, open je de Pull Request via de GitHub-URL en voer je de wijziging door in GitHub.
De database begint als Privé. Als je deze deelt, bepalen de instellingen voor delen van Notion wie de geïmporteerde gegevens kan zien. Kijkers hebben niet elk toegang nodig tot de bron-repository, dus controleer de machtigingen van de database voordat je informatie over een Privé-repository deelt.
Ik kan een organisatie of repository niet vinden
Controleer of je het juiste GitHub-account en de juiste app-installatie hebt geselecteerd. Bevestig dat zowel je account als de app toegang hebben tot de repository. Als een organisatie app-installaties beperkt, vraag dan een eigenaar om toegang goed te keuren.
Een repository is hernoemd of verplaatst
Open de repository-instellingen van de synchronisatie, controleer de repository-selectie en sla deze opnieuw op. Als deze naar een andere organisatie is verplaatst, bevestig dan dat de verbinding toegang heeft op de nieuwe locatie.
De eigenschap Auteur is leeg
Een GitHub-gebruikersnaam heeft niet altijd een beschikbaar openbaar e-mailadres dat overeenkomt met een lid van de Notion workspace. Gebruik Auteur (GitHub) om de auteur te identificeren wanneer de eigenschap persoon leeg is. Wijzigingen in het e-mailadres of het lidmaatschap van de workspace van een auteur worden mogelijk niet automatisch bijgewerkt voor oudere gesynchroniseerde Pull Requests.
Een Pull Request ontbreekt.
Bevestig dat de repository is geselecteerd, dat de laatste update binnen het geschiedenisvenster valt en dat je Notion-weergave deze niet uitfiltert. De eerste import is mogelijk nog bezig.
De database is gestopt met bijwerken
Open de statusdetails van de synchronisatie. Verbind je GitHub-account opnieuw of herstel de toegang tot de repository als daarom wordt gevraagd. GitHub-verzoeklimieten en tijdelijke storingen kunnen updates vertragen terwijl Notion het opnieuw probeert.
Voor een vergelijking met Workers en gedeelde richtlijnen voor probleemoplossing, zie Gegevens synchroniseren van andere tools naar Notion →
