4 min read

Feature

Note: This Integration is being deprecated by December 31, 2022, and will be completely replaced by the New GitHub Integration! Take a look at this article to see what we've upgraded!

GitHub is a version control platform that allows you to track changes to your codebase, flag bugs and issues for follow-up, and manage your product's build process. 

With the monday.com integration with GitHub, you can supercharge GitHub's task-management capabilities and discuss builds with your team before they enter your codebase. 🙌

Add the integration

Note: Only the admin of the Github account will have access to set up the integration. In order to integrate with Github, the Github permissions need to be set to "no restrictions" under the "Third-party application access policy." and admin permissions must be given per repository.

Once you've opened the Integrations Center and go ahead and click "GitHub".

Connect your GitHub account by clicking "Connect to GitHub" and then logging in with your GitHub credentials. 

Customize the integration recipe

Next, select the integration recipe that you want to add to your board. The GitHub actions supported by monday.com are:

• When an item is created, create an issue in this repository. x
• When a status changes to something, create an issue in this repository. 
• When a comment is created on an issue of this repository, create an update in the connected item.
• When tagging a commit in this repository, create an item with this prefix.
• When pull request is opened in repository, create an item and sync future changes from GitHub.
• When pushed to master branch of this repository, create an item.
• When an issue is created in this repository, create an item an sync future changes from GitHub.
• When pushed to master branch of this repository, create an update in this item.
• When an item ID is mentioned in commit to this repository, create an update to the relevant item. 
• When an item ID is mentioned in commit to this repository, add the github link to this column. 
• When an item ID is mentioned in a pull request in this repository, connect it to the item and keep it updated with changes from github.

Note: When adding the item ID to a commit, the item ID must have a hashtag in front of it. For example, if the item ID is 123456, you must write it as #123456. Also, the commit has to first be published to your branch/master for it to then show up in the updates section. 

When setting your integration, you can select which GitHub data points will be mapped into each column on your monday.com board: 

 

GitHub integration column

When selecting which data will be mapped into each column, the GitHub integration column will be added automatically to your board with the tip that will explain the column purpose. This column is created in order to maintain the connection between the parameters in both apps.      

Note: Want more ideas for how to automate and integrate monday.com with other platforms? Check out this article: monday.com automations!

 

 

Supported columns and fields

Below you will find the supported fields for commit, pull requests, tags, and issues.

Additionally, you can integrate with both public and private repositories. You must be an admin of the private repository in order to integrate it with monday.com. 

Use case

• Using monday.com to log Github Issues

With the GitHub integration, you can supercharge your Sprint Planning board by syncing it with your codebase in GitHub! This way, you can communicate about specific issues in monday.com while still having them tracked in GitHub for easy access. 

First, add the "When an item is created, create an issue in this repository" to your board. 

Then, set up a Sprint Planning board with each item as a bug or feature that your team is working on. 

As you add more tasks to your team's sprints, they will also appear in GitHub!