This documentation relates to an earlier version of Confluence.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata

If you are a Confluence Administrator, you can add users and groups, and assign users to groups in order to determine their permissions.

This page tells you how to add a user to a group or remove a user from a group. For an overview of users and groups, please refer to Users and Groups and Confluence User Management.

You can edit group membership in two places:

  • From the group management screen.
  • From the user management screen for a particular user.

Both methods are described below.

On this page:

Adding and Removing Members via the Group Management Screen

This is the recommended method, available in Confluence 2.10 and later. It allows you to manage the group membership for a number of users at the same time.

To add members to a group:

  1. Go to the Confluence 'Administration Console':

    • Choose Browse > Confluence Admin. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click Confirm. You will be temporarily logged into a secure session to access the 'Administration Console'.
  2. Select 'Manage Groups' in the left-hand panel.
  3. The 'Manage Groups' screen appears, showing a list of groups. Select the group to which you want to add users.
  4. The 'Group Members' screen appears, showing the users who belong to the selected group. (See screenshot below.) Click the 'Add Members' link.
  5. The 'Add Members' screen appears, as shown below. Type in the usernames of the people you want to add to the group. You can also search for and select users by clicking the Search icon icon, as described in Searching for Users.
  6. When you have added the required username(s), click the 'Add' button to add the member(s) to the group.

To remove members from a group:

  1. Go to the Confluence 'Administration Console':

    • Choose Browse > Confluence Admin. The 'Administrator Access' login screen will be displayed.
    • Enter your password and click Confirm. You will be temporarily logged into a secure session to access the 'Administration Console'.
  2. Select 'Manage Groups' in the left-hand panel.
  3. The 'Manage Groups' screen appears, showing a list of groups. Select the group from which you want to remove the user.
  4. The 'Group Members' screen appears, showing the users who belong to the selected group. (See screenshot below.) Click the 'Remove user from group' icon next to the user whose group membership you want to remove.


Screenshot above: Group members


Screenshot above: Adding members

Editing Group Membership from the User Management Screen

You can update a user's group membership from the user management screen. This functionality allows you to update one user at a time.

To add a user to a group or remove a user from a group:

  1. Go to the user management screen for the user concerned. There are two ways to do this:
    • Either,
      • Go to the user's Profile and click the 'Administer User' link on the user's profile screen. (This link is available in Confluence 2.8.2 and later.)
    • Or,

      Go to the Confluence 'Administration Console':

      • Choose Browse > Confluence Admin. The 'Administrator Access' login screen will be displayed.
      • Enter your password and click Confirm. You will be temporarily logged into a secure session to access the 'Administration Console'.
      • Select 'Manage Users' in the left-hand panel.
      • The 'Manage Users' screen appears, as shown below. You can now choose to 'Show all users' or you can search for a specific user by entering all or part of the person's username, full name or email address. (For more details about the user search, see Searching For and Managing Users.)
      • Click the link on the username you want to edit.
  2. Now you should be able to see the user's current details, with links allowing you to edit the user's details and groups. See the screenshot showing a user's details below.

  3. Click 'Edit Groups'. This will display two lists of groups, as shown in the screenshot below. Update the user's group membership as follows:
    • 'Not a member of groups' — This box shows all groups to which the user does not belong. To add the user to a group, select a group and click 'Join'. Hold the Ctrl key down and click to select more than one group.
    • 'Member of groups' — This box shows all groups to which the user belongs. Select a group and click 'Leave' to remove the user from the group.


Screenshot above: Managing users


Screenshot above: User details

Screenshot above: Editing a user's groups

Notes

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

RELATED TOPICS