Integrate GitLab commits, branches, and merge requests with ClickUp tasks. This allows users to:
See all GitLab activity related to a task directly in ClickUp.
Optionally receive ClickUp notifications when new GitLab activity items are added to tasks.
Automatically (or manually) attach GitLab activity to ClickUp tasks.
Automatically change Statuses with GitLab actions by adding the ClickUp task id to your commits using this format
Task view 3.0 is currently in beta. Join the 3.0 waitlist. The following instructions apply to both Task view 2.0 and Task view 3.0.
How to Enable GitLab in ClickUp
Step 1 (option 1): Authorize GitLab.com
Note: Only admins can attach repositories to your Workspace's Spaces.
Add GitLab to authorize ClickUp.
Note: You must Authorize to associate GitLab activity with ClickUp tasks:
Step 1 (option 2): Authorize self-hosted GitLab
Note: For security purposes, we require all GitLab integrations that use a self-hosted GitLab instance to have a Top Level Domain (TLD). The URL cannot have a port number appended to it. We do not allow IP addresses or domains that are not recognized as a Top Level Domain. An example of a valid URL would be gitlab.clickup.com.
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
read_user scopes. Set an expiration date.
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:
Manually associating GitLab Commits
Click the GitLab icon on any task
Click on the "Commit" tab
Select a Repo
Select a Branch
Attach your commit
Manually associating GitLab branches
Click the GitLab icon on any task
Click on the "Branch" tab
Select a Repo
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.
Watch the task's status change in this video.
Quickly and easily create new branches from within ClickUp with our quick actions.
Click on the GitLab icon to open the Git modal
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.
Create merge requests from within ClickUp or link existing ones! To create a new merge request in ClickUp:
Click the GitLab icon on the task you'd like to link
Click the "New Merge Request" button
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.
Select a target and source branch
Enter a description
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!
Remove the GitLab integration
Only Workspace owners and admins can remove the GitLab integration.
To remove the GitLab integration:
- In the lower-left corner, click your avatar.
- Select Integrations.
- Select GitLab.
- In the lower-right corner, click Remove Gitlab.
Having trouble with GitLab?
Read our troubleshooting article or ask GitLab customer support here.