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:
Both methods are described below. |
|
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:
-
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 Groups' in the left-hand panel.
- The 'Manage Groups' screen appears, showing a list of groups. Select the group to which you want to add users.
- The 'Group Members' screen appears, showing the users who belong to the selected group. (See screenshot below.) Click the 'Add Members' link.
- 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
icon, as described in Searching for Users. - 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:
-
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 Groups' in the left-hand panel.
- The 'Manage Groups' screen appears, showing a list of groups. Select the group from which you want to remove the user.
- 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.
![GroupMembers.png [Confluence 2.10]](/download/attachments/145958/GroupMembers.png?version=1&modificationDate=1223962332352)
Screenshot above: Group members
![GroupMembersAdd.png [Confluence 2.10]](/download/attachments/145958/GroupMembersAdd.png?version=1&modificationDate=1223962332370)
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:
- 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.
- Either,
- 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.
- 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.
![ManageUsers.png [Confluence 2.10]](/download/attachments/145958/ManageUsers.png?version=1&modificationDate=1224131463069)
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.
RELATED TOPICS
|
Page:
Removing a Group
|
|
Page:
Adding a New User
|
|
Page:
Editing User Details
|
|
Page:
Adding or Removing Users in Groups
|
|
Page:
Global Permissions Overview
|
|
Page:
Viewing members of a group
|
|
Page:
Removing or Deactivating a User
|
|
Page:
Adding a Group
|
|
Page:
Permissions Overview
|
|
Page:
Changing Usernames
|
|
Page:
Global Groups Overview
|
|
Page:
Disabling the Built-In User Management
|
|
Page:
Setting up Anonymous Access
|
|
Page:
Searching For and Managing Users
|
|
Page:
Enabling or Disabling Public Signup
|










13 Comments
Hide/Show CommentsMar 03, 2009
Anonymous
Hello,
I have a question about adding a group. As a space administrator, do I have the permission to add or manage groups? If an instructor wants to arrange his students to be several groups and set up different restrictions for them, how can they use "group" functions to do it? Thank you so much.
Mar 04, 2009
Komathi Krishnan [Atlassian]
Hi,
As a space administrator you can't add or manage groups. Unless if your administrator has given you the Confluence Administrator permission under global permission, then you are allowed to add or manage groups.
The instructor (must have Confluence Administrator permission) can use the user and group browser in Administration Console to organise students into several groups and set up different restrictions through Global Permissions, Space Permissions or Page restrictions.
Cheers,
Komathi
Mar 06, 2009
Anonymous
Hello Komathi,
Thank you so much. It is nice to get your feedback so quickly. It is very helpful. Thank you~~
Apr 28, 2009
Anonymous
I have created a space for my team and i want to give read access for all my team members. The team is about 150 people and adding them individually is tough task. We have an email alias and is it possible to add the email alias and add the members of the email alias automatically.
Thanks for any reply
May 05, 2009
Arie Murdianto
Hi,
I am sorry to say that it is in improvement request to bulk add users in Confluence. You can vote and add yourself as a watcher to receive notification on the following improvement request:
Cheers,
Jun 01, 2009
Anonymous
Hi,
When I am creating a group and adding users, it restricts me from adding more than 20 users. I need to add around 300 users in a group.
How do I do that? Can anyone suggest what could be the problem?
Thanks in advance.
Aug 11, 2009
Azwandi Mohd Aris [Atlassian]
As far as I am concerned, there is no such a limitation. Are you using any plugin to apply the membership?
Jun 26, 2009
Mark Fletcher
I would love to see space-specific user/group management capabilities. In this scenario, the confluence-administrator would define which groups are available for use in a space. The space administrator would be allowed to create users (which the space would then "own"), but could only assign them to groups approved for their space. And space permissions could only be granted to the approved groups and to users "owned" by the space. Has Atlassian considered anything like this?
Jun 30, 2009
Sashidaran Jayaraman [Atlassian]
Hi Mark,
Yea, it would be lovely to see this feature in Confluence. I have found a similar feature request. Please add yourself as a watcher, vote for this feature and add your own comments to this feature request. For further details, you can read on Implementation of New Features and Improvements.
Hope this helps.
Cheers
JSashi
Jun 30, 2009
Mark Fletcher
Beautiful! Thanks, JSashi. I'll have a look.
Oct 02, 2009
Anonymous
Is there anyway to configure confluence to allow space administrators to create groups specific to their spaces?
Feb 23, 2010
Zed Yap [Atlassian]
Hi
As far as I know, the feature requested is not available yet. However, I found a similiar improvement request in JIRA:
Please add your comments to the discussion, vote on it and add yourself as a watcher for future updates. Also, please bear in mind the following document on how we schedule features for inclusion in our products: Implementation of New Features and Improvements.
Hope that helps.
Best rgds,
Zed
Mar 22, 2011
Anonymous
It would be nice to be prompted for confirmation before deleting a user from a group. If the delete button is clicked by accident there is no way of knowing who was just deleted.
Add Comment