Adding Github to ClickUp allows you to associate Github commits, branches, and pushes with ClickUp tasks. This allows you to:
- See all Github activity related to a task directly in ClickUp.
- Optionally receive ClickUp notifications when new Github activity items are added to tasks.
- Automatically (or manually) attach Github activity to ClickUp tasks.
How to enable Github in ClickUp
Step 1: Authorize Github
Note: To add organization repositories, you must check the box to allow ClickUp to access these repositories when authorizing. Here is what your settings page will look like with organization access enabled:
Step 2: Activate Github integration
Click the big purple button to activate Github in your team with just one click.
Step 3: Attach personal repositories to team repositories
ClickUp allows multiple people to authorize Github with your team and also allows you to customize which repositories are shared with your team.
This means, you can authorize your personal account without attaching all of your repositories - you can customize which ones to attach.
Attaching a repository does not give users access to your repository's codebase in anyway - it simply allows users to attach history items for that repository to the Space(s) you specify.
Step 4: Select which Spaces are attached to your repositories
You can customize which Spaces that repositories are attached to by expanding the drop-down on the right side of the 'team repos'. Select one or more Spaces to attach repositories to.
In order to attach Github items to tasks, the Space must be attached to the repository.
Automatically associating Github activity in ClickUp
ClickUp will automatically pick up any new activity and associate them with tasks. To do this, you must:
Add the ClickUp task ID to your commit description with a hashtag in front.
If you need help finding ClickUp task ID's, see this doc.
Manually associating Github activity
- Click the Github icon on any task
- Select a Repo
- Select a Branch
- Attach your commit
Coming Soon: Actions
Soon, you’ll be able to perform Git actions directly inside Click Up.
Do you ever need to create a new feature branch? With Actions, you’ll be able to click to branch off and associate the branch and future commits to that ClickUp task automatically.
Our team is working around the clock to make the world’s best platforms work better together. This awesome GitHub integration is only the beginning.