Join us at Elevate✨ Our virtual conference hits screens Dec 14thJoin us at Elevate conference✨ Tune in Dec 14thRegister now

What can we help you with?

GitHub Integration

 

mceclip0.png
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!

 

Screen_Shot_2020-03-11_at_16.27.35.png

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

To add the GitHub integration, go to the board you want to create it on and click on the "Integrate" button located on the upper right of your screen. 
Group_1_-_2022-09-05T122315.550.png
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".

Group_1_-_2022-09-05T122523.689.png

 

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

Screen_Shot_2019-01-09_at_7_1.png

 

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: 

image_2__16__1.png

 

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.

1_1_1.png

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. 

GitHub_Repository_Recipe__1__1.png

 

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

image_1__45_.png

 

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

2_1__1__1.png

 

More assistance

If you need help building custom integrations, we also have an option for paid assistance through our network of certified monday.com partners. If you're interested, please fill out this form and someone will be in touch shortly! 

 

 

If you have any questions, please reach out to our team right here. We’re available 24/7 and happy to help.