Documentation for Confluence 5.8 (Server).
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

The User Profile macro displays a short summary of a given Confluence user's profile. This is the same summary that appears in a Hover Profile, which appears whenever you mouse over a user's name in the Confluence interface.

Screenshot: Example of the User Profile macro

Using the User Profile macro

To add the User Profile 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 Using Autocomplete.

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 username of the Confluence user whose profile summary you wish to show.

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: profile

Macro body: None.

Storage format example

Wiki markup example

  • No labels


  1. is there no @self parameter? That would be helpful as it would load the current user's info

    1. Hi Sean,

      As far as I know, the feature requested is not available yet. Feel free to launch a feature request in JIRA:


    2. You can create a User Macro with the following features:

      Body: No body

      Output: Macro generates wiki markup



      1. Anonymous

        Do you know how to access other information like phone numbers this way?

        I've tried  $;

      2. Anonymous

        Thank you! So, the macro name is {profile}. Pity this is not at the top of the page.

        1. Hi anonymous, If you would like you look up the macro name and wikimarkup options for each macro - see this page instead Confluence Wiki Markup for Macros

  2. Anonymous

    Is there a similar macro that just displays a users profile picture?

  3. It would be great if you could use this to show the profile summary for every member in a group. Something like:

    That way it could me used to create a nice group directory.

    1. Anonymous

      +1 ...and with an optional table layout would be nice

    2. I'm playing around with the users-report macro. It lists users and some of their profile info in a table.

      Maybe it could include a profile pic.


  4. Any suggestions on why the following code doesn't work? I get a horizontally laid out set of profiles on my page.

    1. Anonymous

      Your code is not correct.  You should use this peace of code instead.

       Expand source
  5. Is customizing the layout/formatting of the user profile view simply a case of editing the velocity template? Where is it located for this macro?




  6. Hello, I had an issue, when I use the TOC (table of contents) and the PROFILE macro, TOC is including in the list of titles/content the name of the user displayed by the PROFILE macro, there is a way to say to TOC macro to not show this name ?



    1. Anonymous

      I have the same problem. Is there no way to suppress the names from any user profile on a page in the table of contents (TOC)? It don´t looks good so.


    2. What you are describing seems to be a confirmed Confluence bug reported here:  CONF-25865 - ToC Macro adds titles from other macros Open

  7. Anonymous

    I would like to use the User Profile macro to display the current user logged in and viewing the page.  We have pages that describe sales sheets, and our sales people would like their contact information to display on the pdf export without having to change the username each time.  Does anybody have a macro to display the same information (name, position, department, email and phone, profile picture is optional)?

  8. Is there any way to change the alignment of the labels?

  9. Anonymous

    we have long email addresses in our company and while using the macro, the email is cut and not completely shown in the page. could you please point me how can I set the email length ?



  10. we have long email addresses in our company and while using the macro, the email is cut and not completely shown in the page. could you please point me how can I set the email length ?



  11. This document seem a little incomplete - I have the option to show custom or namedFields... the problem is I've no idea what those fields are named (Confluence asks for the default title), for the user's name I've tried:

    • User/user
    • userName/Username/UserName
    • Name/name
    • loginName

    but all to no avail i just get the error:

    Error rendering macro 'enhanced-profile' : The specified fields don't exist, please use the default titles (english): user

    I hoped this page would have a handy list of default titles/fields, or at least a link to them but sadly not :/ 

    1. Hi Ian, the error message above makes me suspect that you are perhaps using a different macro. The User Profile macro name is just 'profile' not 'enhanced-profile'.  You may have a third party or user macro perhaps? 

      The only parameter available for the User Profile macro is username, which in the storage format and wikimarkup is called 'user'.   More information is available here Confluence Storage Format for Macros.

  12. Hi Ian Sullivan, it seems that you have our User Profile Plugin installed. If you want to know how to use the enhanced profile macro, please have a look at our documentation or contact us directly via support-confluence[at] Please provide us your Confluence and User Profile Plugin version, when contacting us. Additional screenshots would be also great. I am sure, we will fix your issue.

    Greetings, Stephanie

  13. Why isn't it possible to find pages by searching for the assigned user/userid? Are macro-parameters excluded from confluence search?

    1. Hi Frederik,  that's correct, macro parameters are not included in the Confluence search index.  You can search for instances of a macro on a page, but not by any of the macro's parameters (for example all pages that have a user profile macro for jsmith). Sorry.