Integrate GitLab commits, branches, and pushes with ClickUp tasks. This allows users to: 

  1. See all GitLab activity related to a task directly in ClickUp. 
  2. Optionally receive ClickUp notifications when new GitLab activity items are added to tasks.
  3. Automatically (or manually) attach GitLab activity to ClickUp tasks
  4. Automatically change Statuses with GitLab actions

Pro tip: Add a hashtag followed by a ClickUp task ID and a status enclosed with brackets in your Gitlab commits, to automatically update tasks (like #12345[production]

How to Enable GitLab in ClickUp 

Step 1 (option 1): Authorize GitLab.com 

Note: Only admins can attach repositories to your Team's Spaces

Click Add GitLab  to authorize ClickUp.

Note: You must Authorize to associate GitLab activity with ClickUp tasks:

Step 1 (option 2): Authorize self-hosted GitLab

  1. In your hosted gitlab, go to Settings  in the top right dropdown menu

2. Go to Access tokens  in the left sidebar

3. Create a new access token with the api  and read_user  scopes. 

- Make sure to leave the Expires at  field blank.

4. Copy the personal access token given into ClickUp along with your Gitlab url (ex: https://gitlab.mydomain.com/ ).

Step 2: Attach Personal Repositories to Team Repositories 

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

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

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 of the Team Repos . Select one or more Spaces to attach repositories to. 

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

Automatically associate GitLab activity in ClickUp 

Attaching commits

ClickUp will automatically pick up any new activity and associate it with tasks. To enable this, you must: 

Add the ClickUp task ID in any part of the commit message with a hashtag in front of it.

Example: #12345

Attaching branches

ClickUp can also automatically associate new activity for all commits on a branch. To do this: 

Add the ClickUp task ID in any part of the branch name with a hashtag in front of it.

When a branch is attached to a task, all commits in that branch will be logged to the task, without having to add the Task ID to the commit message.

Example: feature_#12345

Manually associating GitLab Commits

  1. Click the GitLab icon on any task
  2. Click on the "Commit" tab
  3. Select a Repo
  4. Select a Branch
  5. Attach your commit

Manually associating GitLab branches

  1. Click the GitLab icon on any task
  2. Click on the "Branch" tab
  3. Select a Repo
  4. Attach your branch

Automatically change task Status via Gitlab 

You can also change the status of a task from a commit, issue, or merge request . To do this:

Add the ClickUp task ID in any part of the commit message with a hashtag in front of it, as well as the status you want inside brackets

Watch the task's status change in this video. Example: #u7hu[staged]

Coming Soon: Actions

Soon, you’ll be able to perform Git actions directly inside of ClickUp.

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 a ClickUp task automatically.

Having trouble with GitLab?

Read our troubleshooting doc or ask GitLab customer support here.

Be sure to let us know what else you would like to see on our feedback board here!

Did this answer your question?