• Updated

With ClickUp's GitHub integration, users can associate GitHub pull requests, branches, and commits with ClickUp tasks. This allows users to:

  1. See all GitHub activity related to a task directly in ClickUp.

    • When a branch is merged, commits display as a single activity item in the task or in Activity view. A link to all the commits opens a modal, you can click a commit to open it in GitHub.

    • Note: This cuts down on the number and size of your notifications and you can still examine individual commits in detail!

  2. Automatically change Statuses with GitHub actions by adding the ClickUp task id to your commits using this format #{taskID}[status] For example: #1abc2de[closed]

  3. Optionally receive ClickUp notifications when new GitHub activity items are added to tasks.

    • When a branch is merged, commits display as a single grouped notification. A link to all the commits opens a modal, you can click a commit to open it in GitHub.

  4. Automatically (or manually) attach Github activity to ClickUp tasks.

Screenshot showing how a merged branch and commits display in a task.

How to Enable Github in ClickUp

Step 1: Authorize Github

Note: Only ClickUp admins can attach repositories to your Workspace's Spaces. GitHub users must have Admin permissions to repos in order to connect them with ClickUp.

Find the Integrations option on your avatar menu.

  1. From that page, click the GitHub logo to get started.

  2. Click Activate GitHub for Team.

  3. Click + Add GitHub.

  4. If you are logged out of GitHub, you'll be prompted to sign into GitHub.

  5. Review the required permissions.

  6. Click Authorize ClickUp.

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: Attach Personal Repositories to your Workspace

ClickUp allows multiple people to authorize GitHub within your Workspace, and also permits you to customize which repositories are shared with your Workspace.

This means that 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 any way. It simply allows users to attach history items for that repository to the Space(s) you specify.

Screenshot of attaching repositories to a Workspace.
Screenshot of adding a repository to a Workspace.

Step 3: 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. Select one or more Spaces to attach a repository.

In order to attach GitHub items to tasks, the Space must be attached to the repository.

Screenshot of selecting which spaces are attached to a repository.

Automatically Associating GitHub Activity in ClickUp

ClickUp will automatically pick up new GitHub activity and associate it with tasks, as long as you include the ClickUp task ID in any part of the pull request title, branch name, or commit message.

The task id must be formatted using one of these options:




For example:




Manually Associating GitHub Activity

  1. Click the GitHub icon on any task.

  2. Select the pull request, branch, or commit tab.

  3. Select a repo then chose a branch.

  4. Link your pull request, branch, or commit to the ClickUp task.

Automatically Change Task Status via GitHub

You can also change the status of a task from a commit or merge request.

To do this:

Add the ClickUp task ID in any part of the commit message, as shown above, with the status you want inside square brackets.

For example: #ud5b[ready]

Watch the task's status change in this GIF.

GIF of a status change made from GitHub.


Quickly and easily create new branches from within ClickUp with our quick actions.

  1. Click on the GitHub icon to open the Git modal.

  2. On the left-hand side are a variety of auto-generated quick copy options like. suggested name, command to checkout and link a new branch locally, command to link a single commit, or a command to open a pull request.

Screenshot of a new branch being created from ClickUp.

You can customize the auto-generated name used in these options under the GitHub integration settings!

Screenshot of customizing the auto-generated branch name.

Pull requests

Now, you can create pull requests from within ClickUp or link existing ones! To create a new pull request in ClickUp:

  1. Click on the Github icon on the task you would like to link it to and click the "New Pull Request" button.

  2. In the modal, a suggested pull request title will be pre-filled with a suggested title. If you don't like the auto-generated title, you can adjust it in the GitHub integration settings. If changed, be sure to include the task id, CU-taskid , somewhere in the title to ensure it is linked.

  3. Select a target and source branch.

  4. Enter a description.

  5. Create the pull request.

As soon as you create a pull request in ClickUp or link an existing one a link to the associated ClickUp task will be added to the pull request.

Screenshot of a pull request with a link to the associated ClickUp task.

Once a pull request is linked you will be able to see who opened it, the reviewer (if one is assigned), CI/CD status, and pull request status (open, review requested, under review, merged, closed) all from within the linked ClickUp task!

Screenshot of linked pull request details from ClickUp.

Connect Your Personal GitHub Account

In order to create branches and pull requests from ClickUp you need to connect your personal GitHub account. If you try to create a branch or pull request but have not connected your account you will be prompted to connect your GitHub account.

You can also connect or remove your GitHub account from ClickUp at anytime by doing the following:

  1. Click on your user avatar in the bottom right of the screen.

  2. Select My settings.

  3. Chose GitHub from the Sidebar.

  4. If your account is not connected there will be a Connect button you can click to log in to GitHub. If your account is connected already a Disconnect button displays. Clicking it will remove your GitHub account from ClickUp.

Screenshot of Connect button in personal GitHub account.

Note: This only affects creating GitHub branches or pull requests from within ClickUp. It will NOT remove the associated repos or git activity from the Workspace. To do that you will need to be an admin and go to the Workspace settings.
Note: Guests can't use this integration.

Automating your workflows

ClickUp's native Automations also support workflows with external applications like GitHub.

Unlock unparalleled development power with tons of GitHub automations to change the way you code alongside ClickUp. Select from numerous GitHub triggers and actions, and map data for an extended workflow.

Learn more here.

Was this article helpful?