Content by User Macro

The Content by User macro generates a tabulated list of the content items, throughout the Confluence installation, that have been created by a specified Confluence user. The list includes all current pages, comments and spaces created by the user. Each item in the table is linked to its corresponding page, page comment or space dashboard.

Note that items for page comments contain a link to the page, followed by a second link to the comment itself, with these separated by a greater-than sign (>).

Using the Content by User macro

To add the Content by User macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Autocomplete for links, files, macros and mentions.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.


Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).









The Confluence username for a person who has created content.

Parameter is unnamed in wikimarkup.

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: content-by-user

Macro body: None.

Storage format example

Wikimarkup example

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

6 Archived comments

  1. User avatar


    some more parameter would be nice – for example



    *max-count:0..999 etc.

    01 Jun 2011
    1. User avatar

      Edwin Dawson [Atlassian Technical Writer]

      Hi there,

      Thanks for the suggestion.

      If you'd like to pursue this idea, why not create a feature request on our issue tracker for the Confluence developers?

      I hope this helps.

      Best Regards,

      Edwin Dawson
      Technical Writing Team Leader

      07 Jun 2011
  2. User avatar


    Can you use this with @self to get a list of pages that you have created?

    27 Feb 2013
    1. User avatar

      Bobs Yeruncle

      Tried it... nope (sad)

      30 Sep 2014
  3. User avatar

    J Michael

    Marco is not producing any results for me, v5.6.3. Is there a KB article to configure?

    10 Feb 2015
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      This is a pretty simple macro, and the only parameter you need to configure is the username.  When entering the username, Confluence will select a list of users that match - you need to select the person you want to show content for.   Otherwise that's it.

      If you still have trouble getting this macro to work, I'd recommend contacting support as there might be an issue with your index. 

      10 Feb 2015
Powered by Confluence and Scroll Viewport