Help us learn about your current experience with the documentation. Take the survey.

ClickUp

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

You can use ClickUp as an external issue tracker. To turn on the ClickUp integration in a project:

  1. In the top bar, select Search or go to and find your project.

  2. In the left sidebar, select Settings > Integrations.

  3. Select ClickUp.

  4. Under Enable integration, select the Active checkbox.

  5. Fill in the required fields:

    • Project URL: The URL to the ClickUp project to link to this GitLab project.
    • Issue URL: The URL to the ClickUp project issue to link to this GitLab project. The URL must contain :id. GitLab replaces this ID with the issue number.

  6. Optional. Select Test settings.

  7. Select Save changes.

After you configure and turn on ClickUp, a link appears on the GitLab project pages. The link directs you to your ClickUp project.

For example, this is a configuration for a project named gitlab-ci:

  • Project URL: https://app.clickup.com/1234567
  • Issue URL: https://app.clickup.com/t/1234567/:id

You can also turn off GitLab internal issue tracking in this project. For more information about the steps and consequences of turning off GitLab issues, see:

Reference ClickUp issues in GitLab

You can reference your ClickUp issues using:

  • #<ID>, where <ID> is an alphanumerical string (example #8wrtcd932).
  • CU-<ID>, where <ID> is an alphanumerical string (example CU-8wrtcd932).
  • <PROJECT>-<ID>, for example API_32-143, where:
    • <PROJECT> is a ClickUp list custom prefix ID.
    • <ID> is a number.
  • If you use Custom Task IDs, the full custom task ID also works. For example SOP-1234.

In links, the CU- part is ignored and it links to the global URL of the issue. When a custom prefix is used in a ClickUp list, the prefix part is part of the link.

Use the CU- format (CU-<ID>) if you have both internal and external issue trackers turned on. If you use the shorter format, and an issue with the same ID exists in the internal issue tracker, the internal issue is linked.

For Custom Task IDs, you must include the full ID, including your custom prefix. For example, SOP-1432.