diff --git a/doc/user/project/integrations/clickup.md b/doc/user/project/integrations/clickup.md index 48151368d8db7f08297814458dd87d6ae34b7b77..d190fb3d7ec10c77a2edd5ec9bac9665b9ba2fc2 100644 --- a/doc/user/project/integrations/clickup.md +++ b/doc/user/project/integrations/clickup.md @@ -34,7 +34,7 @@ which takes 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/:id` +- Issue URL: `https://app.clickup.com/t/1234567/:id` You can also disable [GitLab internal issue tracking](../issues/index.md) in this project. For more information about the steps and consequences of disabling GitLab issues, see @@ -49,6 +49,8 @@ You can reference your ClickUp issues using: - `<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](https://help.clickup.com/hc/en-us/sections/17044579323671-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. @@ -56,3 +58,5 @@ prefix is used in a ClickUp list, the prefix part is part of the link. We suggest using the `CU-` format (`CU-<ID>`) if you have both internal and external issue trackers enabled. 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](https://help.clickup.com/hc/en-us/sections/17044579323671-Custom-Task-IDs), you **must** include the full ID, including your custom prefix. For example, `SOP-1432`.