ClickUp uses two types of links: public links and internal links. Knowing the difference helps you share the right link and troubleshoot issues faster.
Internal links require you to be a member of the Workspace with permission to access the item.
Public links can be accessed by anyone with the link, even people outside your Workspace.
On Enterprise Plans, Workspace Auth or OpenID Connect settings can require sign-in even for public links. A public link makes the item shareable on the web, but access depends on the item type and your Workspace's authentication settings.
Public links
Public links let anyone view or interact with shared content without logging in to ClickUp. They use the domain specific to the shared item type.
Examples of public links:
- Forms:
https://forms.clickup.com/{workspace_id}/f/{form_id}/{token} - Shared Docs:
https://doc.clickup.com/{workspace_id}/d/h/{doc_id}/{token} - Shared views:
https://sharing.clickup.com/{workspace_id}/{view_key}/h/{view_id}/{token}
For shared views, {view_key} is a short code for the view type: c for Calendar, tl for Timeline, l for List, b for Board, g for Gantt, gr for Table, fm for Form, mm for Mind Map, m for Map.
Public links use a domain like forms.clickup.com, doc.clickup.com, or sharing.clickup.com. If you see one of these domains, the link is public.
Internal links
Internal links open items inside ClickUp for logged-in Workspace members. They always use the domain app.clickup.com.
The general format is: https://app.clickup.com/{workspace_id}/v/{view_path}/{item_id}.
Only people who are members of your Workspace and have access to the item can open internal links.
URL structure by item type
Each item type in ClickUp has a unique URL pattern. Here's what each one looks like and what each section means.
Spaces
The general format is: https://app.clickup.com/{workspace_id}/v/o/s/{space_id}.
| Segment | Meaning |
| app.clickup.com | Internal ClickUp domain |
| {workspace_id} | Your Workspace's unique number |
| /v/o/s/ | View path for Space overview |
| {space_id} | The Space's unique ID |
Folders
The general format is: https://app.clickup.com/{workspace_id}/v/o/f/{folder_id}.
| Segment | Meaning |
| /v/o/f/ | View path for Folder overview |
| {folder_id} | The Folder's unique ID |
Lists
The general format is: https://app.clickup.com/{workspace_id}/v/li/{list_id}.
| Segment | Meaning |
| /v/li/ | View path for List |
| {list_id} | The List's unique ID |
You may also see /v/l/{list_id} for Lists. Both /v/li/ and /v/l/ resolve correctly.
Tasks
The general format is: https://app.clickup.com/t/{workspace_id}/{task_id}.
| Segment | Meaning |
| /t/ | Task route |
| {workspace_id} | Your Workspace's unique number |
| {task_id} | The task's unique alphanumeric ID |
Tasks put the Workspace ID after /t/, unlike other item types. The short form https://app.clickup.com/t/{task_id} also works, but including the Workspace ID is what makes custom task IDs resolve correctly.
Form views (internal)
The general format is: https://app.clickup.com/{workspace_id}/v/fm/{form_id}.
| Segment | Meaning |
| /v/fm/ | View path for Form |
| {form_id} | The Form view's unique ID |
Docs (internal)
The general format is: https://app.clickup.com/{workspace_id}/docs/{doc_id}.
| Segment | Meaning |
| /docs/ | Route for Docs |
| {doc_id} | The Doc's unique ID |
You may see some older internal Doc links using the path /v/dc/{doc_id}. This format may be outdated. When you copy a Doc's internal link today, it uses the /docs/ format shown above.
How to identify a link type
Look at the domain:
app.clickup.com: Internal link, requiring Workspace membership and permission.forms.clickup.com,doc.clickup.com, orsharing.clickup.com: Public link, allowing anyone with the link to access it.
Build an internal link from a public link
If you have a public link and need the internal version for troubleshooting, you can build it manually:
- Find the Workspace ID and item ID in the public URL. For example, in
https://forms.clickup.com/18039809/f/h6h01-928451/ZPH7IPM6496E05V1K1, the Workspace ID is18039809and the Form ID ish6h01-928451. - Place those values into the internal URL format for that item type. For a Form, that's:
https://app.clickup.com/18039809/v/fm/h6h01-928451 - Open the link in your browser while logged in to the Workspace.
Copy an internal link
Copy the internal link for any item directly from ClickUp:
- Tasks: Right-click a task in any view, then select Copy link.
- Lists, Folders, Spaces: Right-click the item in the Sidebar and select Copy link.
- Docs: Click the Share button, then Copy link.
- Views: In the Views Bar, right-click the view and select Copy link to view.