User Profile Macro

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

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

27 Archived comments

  1. User avatar

    Sean Winter

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

    06 May 2010
    1. User avatar

      Zed Yap [Atlassian]

      Hi Sean,

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


      11 May 2010
    1. User avatar

      Giampiero Restaino [Reply S.p.A.]

      You can create a User Macro with the following features:

      Body: No body

      Output: Macro generates wiki markup



      10 Aug 2010
      1. User avatar


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

        I've tried  $;

        22 Oct 2010
      1. User avatar


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

        17 Oct 2013
        1. User avatar

          Rachel Robins [Atlassian Tech Writer]

          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

          17 Oct 2013
  2. User avatar


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

    06 Aug 2010
    1. User avatar

      Azwandi Aris [Atlassian]

      You might be interested in Profile Image Macro, an instance of Writing User Macros.

      19 Aug 2010
  3. User avatar

    Eliane Pohl

    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.

    15 Feb 2011
    1. User avatar


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

      07 Jul 2011
    1. User avatar

      Karen Wright

      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.


      21 Feb 2012
  4. User avatar

    Parag Bhatnagar

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

    05 Aug 2011
    1. User avatar


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

       Expand source
      19 Aug 2011
  5. User avatar

    Mark Gibaud

    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?




    22 Dec 2011
  6. User avatar

    Eduardo F. Sandino

    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 ?



    18 Jan 2012
    1. User avatar


      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.


      21 Aug 2012
    1. User avatar

      Andreas van Rienen (Scandio)

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

      25 Jul 2014
  7. User avatar


    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)?

    08 Mar 2012
    1. User avatar

      Karen Wright

      You might be able to customise the Confluence Metadata Plugin. See

      12 Mar 2012
  8. User avatar


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

    02 Apr 2013
  9. User avatar


    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 ?



    15 Oct 2013
  10. User avatar

    Gabriel Almeida

    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 ?



    15 Oct 2013
  11. User avatar

    Ian Sullivan

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

    22 Nov 2013
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      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.

      25 Nov 2013
  12. User avatar

    Stephanie Hoffmann [Communardo]

    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

    25 Nov 2013
  13. User avatar

    Frederik Holm

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

    10 Mar 2015
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      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.  

      10 Mar 2015
Powered by Confluence and Scroll Viewport