Use @mentions

Use @mentions to get your teammates' attention or to share items.

Screenshot of the mention modal.

Use @mentions

You can @mention a person or item in most places in ClickUp where text is accepted. For example, in AI prompt fields, task descriptions, task comments, Channels, direct messages, Notepad, and when replying to a comment from Inbox.

Once a task or Doc is archived, you won't be able to mention it.

@mention Brain

Quickly open Brain Assistant from task comments and chat messages to summarize the context, take action, or to craft the perfect reply. Simply press the Space bar, or type @brain.

@mention people

To @mention a person: 

  1. Type @ and a person or Team's initials.
    • Or, if it's available you can click the @ icon and select the People tab. 
  2. Choose the person or Team. You can @mention all assignees or watchers using @watchers or @assignee. If you're in a Channel, you can use @everyone to notify all Followers.
    • Names are prioritized by how often you tag them.

Depending on your notification settings, you can receive Inbox notifications when you're @mentioned in a comment, task description, or Doc.

When you're @mentioned in Chat, you'll see a red badge next to the Channel or direct message. If you're using ClickUp 4.0, Chat messages you're @mentioned can be accessed from the My Comments page.

@mention people in a task

When you @mention a person in a task the following happens:

  • When they're mentioned in a task comment, they become a watcher of that task.
  • When they're mentioned in a task description, they will not be added as a watcher. 
  • When they're mentioned in a task description, they will receive a notification
  • The comment they're mentioned in is highlighted in the task.
  • Their names are highlighted in their Inbox
  • You can mention people who don't have access to a task. You can set their permission level and invite them to the task. If you choose not to give someone access to the task, they won't be notified that they were mentioned.

Screenshot of a comment with @mentions.

Take a look at our assigned comments article to learn how to assign small action items. 

@mention a task

To @mention a task:

  1. Type @@.
    • Or, if it's available you can type @ and select the Tasks tab.
  2. Select the task. 

When you @mention a task within a task, it is automatically added as a Reference Relationship

@mention a Doc page

To @mention a Doc page:

  1. Type @@@.
    • Or, if it's available you can type @ and select the Docs tab. 
  2. Select the Doc.

@mention Whiteboards

To @mention a Whiteboard

  1. Type @@@@.
    • Or, if it's available you can type @ and select the Whiteboards tab. 
  2. Select the Whiteboard. 

@mention Lists

To @mention a List:

  1. Type @/.
    • Continue typing in the name of the List to filter results.
  2. Select the List.

@mention Channels

If the Chat ClickApp is activated in your Workspace, you can @mention Channels:

  1. Type #.
    • Or, if it's available you can type @ and select the Channels tab. 
  2. Select the Channel. 

@mention people in a Doc

You can't mention others in Docs unless the Doc has been shared with them.

Was this article helpful?