Not seeing repositories that should be available? This help article will guide you through some initial troubleshooting steps with our GitHub integration.
What you'll need
- The GitHub integration is available on all ClickUp Plans.
- You'll need to be a Workspace owner or admin to set up integrations and link GitHub with Spaces.
- You'll need admin permissions to each repository to link them to a ClickUp Space.
- Workspace members can link their GitHub and ClickUp accounts to create new branches and pull requests from ClickUp.
- Guests cannot use the GitHub integration.
Repositories are missing from ClickUp
When a Workspace owner or admin authorizes GitHub, they can authorize access to:
- Their personal repos owned by their GitHub user account.
- And repos from organizations they've joined in GitHub, where their GitHub account has admin permissions.
When authorizing ClickUp with GitHub, to add organization repositories, click Grant to allow ClickUp to organization access.
Both personal and organization repos will appear in ClickUp under My repositories from GitHub on the integration settings page.
Re-authenticate or remove GitHub
Sometimes, you might accidentally connect with the wrong GitHub account, or maybe there's been an issue with the connection. In this case, you might want to disconnect and reconnect your repos or your entire account.
These actions do not impact anyone's ability to access repos using their GitHub account through GitHub.
You can take the following actions from the Integrations page by clicking on the GitHub icon:
- Re-authenticate GitHub: This refreshes the authorization between ClickUp and your Github account.
- It does not remove any repos added under GitHub repositories added to ClickUp.
- It may refresh the list of My repositories from Github if you've logged into a different GitHub account.
- Remove authorization for my GitHub repositories: This removes your authorization between ClickUp and your GitHub account.
- This removes any of your repos linked to Spaces under GitHub repositories added to ClickUp .
- This removes any of your repos that appeared under My repositories from GitHub.
- It does not impact repos authorized and added by other people.
- Remove Github from your Workspace: This removes all repositories from Spaces in the Workspace
- It removes all repos from all Spaces, including those added by other people, under GitHub repositories added to ClickUp.
- It does not impact anyone's authorization of ClickUp with GitHub or anyone's My repositories from GitHub.
I can't see the GitHub icon on my tasks
If you've joined the Workspace as a guest, you won't be able to use the GitHub integration. Contact your Workspace owner or admin to request to be upgraded to a Workspace member.
GitHub activity is missing from ClickUp tasks
The task activity feed sometimes collapses similar activity items to ensure you see the most important details.
- Click More updates to reveal activity that has been hidden.
- When a branch is merged, commits display as a single activity item in the task's activity feed.
- Click the link to all the commits to open a modal.
- Click an individual commit to open it in GitHub.
- You can also filter task activity by Git items.
Linking tasks by ID
Double-check that you're referencing the ClickUp task ID correctly to link activity in GitHub. You can use any of these three options to reference your ClickUp tasks on commits, branch names, and pull requests:
You can manually link ClickUp tasks with GitHub commits, branches, and pull requests from the ClickUp task.