What's the difference between public and internal links?

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, or sharing.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:

  1. 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 is 18039809 and the Form ID is h6h01-928451.
  2. 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
  3. 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.