Troubleshooting GitHub

  • Updated

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.

Screenshot showing different repositories that can be added to ClickUp.

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.

Screenshot highlighting the different options to remove Github authorization, re-authenticate Github, or remove Github within the ClickUp settings.

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.

Once ClickUp has been authorized with GitHub, a Workspace owner or admin needs to add repos to one or more Spaces under the GitHub repositories added to ClickUp section. This section also includes repos authorized and added to your Workspace by others people.
Screenshot highlighting the 'Github testing' option in the 'my repositories from Github' menu in ClickUp.

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.

Screenshot of the Git items task activity filter.

 

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:

#{task_id}

CU-{task_id}

{custom_task_id}

For example:

#1abc2de

CU-1abc2de

prefix-1

You can manually link ClickUp tasks with GitHub commits, branches, and pull requests from the ClickUp task.

Was this article helpful?