Displays a list of pages where a specific user is @mentioned in the page content. A mention is a direct @username reference inserted while editing a page. This macro helps teams find all content that references a particular person.
5.1 Content & Filter Tab
Required Fields
|
Field |
Type |
Description |
Required |
|---|---|---|---|
|
Mentioned User |
User Search |
Select one or more users. Results will include pages where any of the selected users is @mentioned in the page content. At least one user is required. |
Yes |
Optional Settings
|
Field |
Type |
Description |
Required |
|---|---|---|---|
|
Exclude Current Page |
Toggle |
Hides the page the macro is placed on from results. Default: off. |
No |
|
Add Filter |
Filter Panel |
Add optional filters to narrow results. See Section 2 for all available filters. |
No |
|
Sort By |
Dropdown |
Sort results by: Title, Created Date, Last Modified. |
No |
|
Descending / Ascending |
Toggle |
Toggle sort direction. Default: Descending. |
No |
What counts as a mention?
A mention is an @username reference inserted using the @ symbol in the Confluence editor.
Mentions in comments are not included - use Content by Contributor with the Comment by User filter for that use case.
If a user's profile is deleted, pages that mentioned them may no longer return results for that user.
5.2 Display, Layout & Advanced Tabs
These tabs are identical to Content by Author. Refer to sections 3.2, 3.3, and 3.4.
5.3 Use Cases
-
Stakeholder pages - find all pages that mention a project manager or decision-maker.
-
Person profile page - embed on someone's profile to show every page in the space that references them.
-
Offboarding - before removing a user, find all pages that @mention them so they can be updated.
-
Compliance and review - find all pages that mention a specific reviewer or approver.