Documentation for Confluence 5.4.
Documentation for Confluence OnDemand 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

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

Parameter

Default

Description

Username
(user

none

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

24 Comments

  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:

      Cheers,
      Zed

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

      Body: No body

      Output: Macro generates wiki markup

      Template: 

      ;-)

      1. Anonymous

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

        I've tried  $req.userPrincipal.phone;
        $req.userPrincipal.ph;
        $req.userPrincipal.Phone}

      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.

      See https://studio.plugins.atlassian.com/wiki/display/META/Confluence+Metadata+Plugin#ConfluenceMetadataPlugin-usersreport

  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?

     

    Thanks!

    Mark.

  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.

       

  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 ?

    thanks.

     

  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 ?

    thanks.

     

  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]communardo.de. 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