Integrate GitLab commits, branches, and merge requests 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 by adding the ClickUp task id to your commits using this format #{taskID}[status] For example: #1abc2de[closed]

How to Enable GitLab in ClickUp 

Step 1 (option 1): Authorize 

Note: Only admins can attach repositories to your Workspace'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: ).

Step 2: Attach Personal Repositories to ClickUp 

ClickUp allows multiple people to authorize GitLab 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. 

Step 3: Select which Spaces are attached to your Repositories 

You can customize which Spaces repositories are attached to by expanding the drop-down on the right side of the page. 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 

ClickUp will automatically pick up any new activity and associate it with tasks.

To enable this, you must: 

Add a ClickUp task ID in any part of the merge request title, branch name, or commit message in one of these formats:




For example:




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 the status you want inside square brackets.

For example: #u7hu[staged]

Watch the task's status change in this video.


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

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

  2. On the left 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 merge request

Customize the auto-generated name used in these options under the GitLab integration settings!

If you prefer to create a new branch directly in GitLab, click the "New Branch" button in the GitLab modal.

Merge requests

Create merge requests from within ClickUp or link existing ones! To create a new merge request in ClickUp:

  1. Click the GitLab icon on the task you'd like to link

  2. Click the "New Merge Request" button

  3. In the modal, a suggested merge request title will be pre-filled with a suggested title. If you don't like the auto-generated title, adjust it in the GitLab integration settings.

  4. Select a target and source branch

  5. Enter a description

  6. Create the merge request

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

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

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?