Confluence User mentions not working

Understanding Confluence: A Brief Overview

Confluence is a powerful collaboration tool used by teams to create, share, and collaborate on projects and documents. It is part of the Chat & Communication Tools category and is widely used for its ability to integrate with other Atlassian products like Jira. Confluence allows users to create spaces for different teams or projects, where they can manage content and communicate effectively.

Identifying the Symptom: User Mentions Not Working

One common issue users encounter in Confluence is the failure of user mentions to work correctly. This symptom is observed when a user tries to mention another user in a page or comment, but the mention does not link to the intended user's profile or does not appear at all.

Exploring the Issue: Possible Causes

Incorrect Mention Syntax

One possible cause for this issue is the use of incorrect mention syntax. In Confluence, mentions are created by typing the '@' symbol followed by the user's name. If the syntax is incorrect, the mention will not work.

User Not Part of the Space

Another common cause is that the user being mentioned is not part of the space where the mention is being made. Confluence requires users to have access to the space to be mentioned.

Steps to Fix the Issue

Ensure Correct Mention Syntax

To resolve the issue, first ensure that you are using the correct syntax for mentions. Type '@' followed by the user's name and select the user from the dropdown list that appears. For more details on using mentions, refer to the official Confluence documentation.

Verify User Access to the Space

Check if the user you are trying to mention has access to the space. You can do this by navigating to the space settings and reviewing the list of users and groups with access. If the user is not listed, you will need to add them to the space. For guidance on managing space permissions, visit Confluence's permissions management guide.

Conclusion

By ensuring the correct mention syntax and verifying user access to the relevant space, you can resolve the issue of user mentions not working in Confluence. These steps will help maintain effective communication and collaboration within your team. For further assistance, consider reaching out to Atlassian Support.