Documentation for Confluence 5.5.
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

This page describes how to use the 'User Search' window, which appears when you click Choose Users or a user search icon on a Confluence page.

Accessing the User Search

To access the 'User Search' window:

  1. Choose the user search icon when you are performing one of the following actions:
    • When assigning space permissions, choose the user search icon in the users section.
    • When adding members to a group, choose the user search icon.


       
  2. The simple 'User Search' window will appear, as shown below.

On this page:

Related pages:

Using the Simple User Search

To search via the simple user search:

  1. Select the User tab on the 'User Search' screen. (See above for instructions on accessing the screen.)
  2. Enter information about the user in the User Details field, such as all or part of a username, full name or email address. 
  3. Choose Search.
  4. Confluence will return a list of matching users. See below for instructions on selecting one or more users.

Screenshot: Simple user search


Searching for Users in One or More Groups

You can also list the users who appear in a particular group or in a set of groups.

To search for users in a particular group:

  1. Select the Membership tab on the 'User Search' screen. (See above for instructions on accessing the screen.)
  2. Enter all or part of a group name into the Group Membership field.
  3. Choose Search.
  4. Confluence will return a list of users belonging to any groups which match your search term.
    (tick) In the example screenshot below, we entered a group name of 'dev'. The search results show all users belonging to the group 'developers' and all users belonging to the group 'developers-mates'.
  5. Now you can select one or more users, as described below.

Screenshot: Searching for users in a group


Selecting One or More Users

After searching for users and receiving a list of names from Confluence, as described above, you can now select the user(s) you need.

To select one or more users:

  1. Click the box next to the username(s) to select or deselect one or more users.
    You can click Check All to select or deselect all users.
  2. Click Select User(s).
  3. The 'User Search' window will close and the selected users will appear on the screen which you were using before you accessed the user search.

Notes

  • Case sensitivity: The search is not case sensitive. You can enter either upper- or lower-case text, and it will make no difference to the search results.
  • Wild cards: The search allows the asterisk as a wild card, but you do not need to use it. The search results will be the same whether you use a wild card or not. The wildcard functionality remains available for compatibility with older versions of Confluence.
  • Multiple user directories:You may define multiple user directories in Confluence, so that Confluence looks in more than one place for its users and groups. For example, you may use the default Confluence internal directory and also connect to an LDAP directory server. In such cases, you can define the directory order to determine where Confluence looks first when processing users and groups.

    Here is a summary of how the directory order affects the processing:

    • The order of the directories is the order in which they will be searched for users and groups.
    • Changes to users and groups will be made only in the first directory where the application has permission to make changes.

    See Managing Multiple Directories.

  • Crowd and the user search: If you are using Atlassian's Crowd for user management, you will need Crowd 1.5.1 or later to use the 'Simple' option in the user search. If your version of Crowd does not support the simple user search, you will see only the 'Advanced' search form.
  • No labels

2 Comments

  1. If I'm reading this right, the user search still only allows you to select all of the users on the first search result screen, not all of the members of a group - which unfortunately doesn't seem like a huge improvement.  I have 200+ users in an LDAP email distribution group ("Everyone Email List") that I need to add to confluence-users, and I was hoping for something like the plugin in the screenshots here:

    http://jira.atlassian.com/browse/CONF-2191

    Would I be better off just granting permissions to "Everyone Email List" and using it as my confluence-users group?

    thanks!

    1. Hi Roger,

      Currently, Confluence allows you to join users from a particular group to another group. However, it doesn't support group joining. That means, from the group level view, you can't simply join a group to another.

      I have raised an improvement request on your behalf via:

      Please cast your vote and add yourself as a watcher to the improvement request for future updates.

      Would I be better off just granting permissions to "Everyone Email List" and using it as my Would I be better off just granting permissions to "Everyone Email List" and using it as my confluence-users group??

      If you would like to join users from a group to the "confluence-users" group, in Confluence 2.10 you can follow the steps below:

      1. Go to Admin->Manage Groups
      2. Click on the "confluence-users" group
      3. Click on the "Add Members"link. This is to add the member from a particular group to the "confluence-users" group
      4. Search for the users from the group. You can use the search "Membership" feature
      5. Select and add the users to the "confluence-users" group

      Hope this helps.

      Regards,
      MG