Mentions

Mentions (often known as @mentions) are a useful way of drawing someone's attention to a page or comment, or assigning a task to them. When you mention a user, they'll receive a notification by email and in their workbox; if you mention them in a task, the task is assigned to them and appears in their tasks list.

There are two ways to mention someone: using autocomplete, or via the Insert menu in the editor toolbar.

Use autocomplete

To mention someone using autocomplete, type '@' in the editor then start typing their name. Choose the person you want to mention from the list of suggestions. 

Confluence will suggest people you've mentioned previously (after yourself, of course).


It then continues to suggest matches as you type. If you've not mentioned the person recently, we'll also include information about whether they've commented or contributed to the current page, to help you find the right person, fast. 

Use the Insert menu

If you'd rather use the Insert menu, choose Insert > User Mention then search for and select the user you want to mention.

Notes

  • Disable mentions – The functionality is provided by a plugin called the 'Confluence Mentions Plugin'. If you need to remove the user mention functionality from your site, you can disable the plugin. See Disabling or Enabling a Plugin.
  • Mentioning groups – You can only mention individual users who have the 'Can Use' Confluence global permission. There's a feature request to allow mentions for groups: CONF-23015 - Getting issue details... STATUS
  • Link to a user profile – You can use a square bracket '[' and a person's name to trigger Confluence autocomplete and link to a person's user profile or personal space. Confluence will send the person a notification just as if you had used @mention (unless the administrator has disabled the user mention feature).
  • Mention notifications - A notification is sent to the people you mention the first time you mention them, but not for subsequent mentions. If you need to catch someone's attention, and you've already mentioned them, try sharing the page with them instead.
  • Frequently mentioned people - Confluence relies on your browser's local storage to remember the people you mention regularly. You may see different results if you switch devices, or don't allow local storage.  Confluence doesn't indicate whether someone is a creator, contributor or commenter when they are also a recent mention (because we're grabbing them straight from your local storage, not the page itself). 
Last modified on May 8, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.