Searching for Users

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.

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.


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

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport