Adding or Removing Users in Groups

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 Confluence Groups and Manage Users.

You can edit group membership in two places:

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

On this page:

Related pages:

Add and remove members via group management

This is the recommended method. It allows you to manage the group membership for a number of users at the same time.

To add members to a group:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Choose Groups in the left-hand panel
  3. Choose the group to which you want to add users
  4. Choose Add Members
  5. Type the username(s) of the people you want to add to the group
    • If you want to add more than one member, separate the usernames with commas
    • You can also search for and select users by choosing the search icon
  6. Choose Add to add the member(s) to the group

To remove members from a group:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration
  2. Choose Groups in the left-hand panel
  3. Choose the group from which you want to remove the user
  4. Choose the Delete user from group icon next to the user whose group membership you want to remove

Screenshot: Adding members

Edit group membership via user management

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 choose Administer User on the user's profile screen.
    • Or, Choose the cog icon , then choose General Configuration under Confluence Administration
      1. Choose Users in the left-hand panel
      2. Choose Show all users, or search for a specific user by entering all or part of their username, full name or email address
      3. Choose the username you want to edit
  2. Choose Edit Groups
  3. Select the group(s) for this user
    To remove a user from a group, remove the tick mark in the relevant check box.

Screenshot: Editing a user's groups

You can define multiple user directories in Confluence, so that Confluence looks in more than one place for its users and groups. For example, you could use the default Confluence internal directory and connect to an LDAP directory server. In that case, 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.

Was this helpful?

Thanks for your feedback!

35 Archived comments

  1. User avatar

    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.

    03 Mar 2009
    1. User avatar

      Komathi Krishnan [Atlassian]

      Hi,

      As a space administrator, do I have the permission to add or manage groups?

      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.

      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?

      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

      04 Mar 2009
      1. User avatar

        Anonymous

        Hello Komathi,

        Thank you so much. It is nice to get your feedback so quickly. It is very helpful. Thank you~~

        06 Mar 2009
  2. User avatar

    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

    28 Apr 2009
    1. User avatar

      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,

      05 May 2009
  3. User avatar

    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.

    01 Jun 2009
    1. User avatar

      Azwandi Aris [Atlassian]

      As far as I am concerned, there is no such a limitation. Are you using any plugin to apply the membership?

      11 Aug 2009
  4. User avatar

    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?

    26 Jun 2009
    1. User avatar

      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

      30 Jun 2009
      1. User avatar

        Mark Fletcher

        Beautiful! Thanks, JSashi. I'll have a look.

        30 Jun 2009
  5. User avatar

    Anonymous

    Is there anyway to configure confluence to allow space administrators to create groups specific to their spaces?

    02 Oct 2009
    1. User avatar

      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

      23 Feb 2010
  6. User avatar

    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. 

    22 Mar 2011
  7. User avatar

    Anonymous

    Hi. My users and groups from JIRA are automatically synced to the user database of confluence. So in confluence there are the jira-groups (jira-users, jira-developers...).

    When a confluence user creates a new space, only users in the group "confluence-users" can access that space. So it's necessary to give manually the jira-users group permissions in the space admin. Is it possible to add the jira-users group to the confluence-users group?

    01 Jun 2012
  8. User avatar

    Anonymous

    it'll be nice for space admin to, at lest, have read permission on global group members and even better to be able to create space level user group with edit permission. The benefits is it'll give space admin flexibility to manage user group in space level and reduce system admin work. System admin should only manage/maintain some critical global user group like confluence-users, confluence-administrators. Similar issur for JIRA (project admin) as well. I'd like to see this function be available on next version release, or already added in update version?

     

    David

    25 Jan 2013
  9. User avatar

    lei yang

    Hi, I want to send a message to all members. I have to '@' them one by one. Can I '@' a group?

     

    Lei 

    Thanks.

    06 Jun 2013
  10. User avatar

    Andre Castillo

    So, I'm sort of at a loss for words. I've tried more than a million ways to bulk add users to a new group. For example, if I go to "Groups" then create a new group, and then go into that group to add users, I can only add them one by one in the add users box. There's no bulk adding mechanism that I can see anywhere. Even the "Bulk Add" button at the top right, doesn't allow you to bulk add users. 

    Am I missing something?

    29 Apr 2014
    1. User avatar

      lingling Liao

      I need the bulk adding user function too. We have hundreds of users to be added.

      15 Aug 2014
    1. User avatar

      Hans-Peter Geier

      I believe this would be a nightmare to try it manually.

      You may have a look into the CLI add-on (created by Bob Swift) and create some script.

      Then you are much faster than waiting for Atlassian to provide a solution.

      26 Aug 2014
    1. User avatar

      David Wu

      you can bulk add users to a group in this way:

      group page>add member>copy all users id separate with comma in "add members field" (ie.u20405,u18547,u19862,u05092>click "add" button>done

      11 Aug 2015
  11. User avatar

    Alice

    When I go to add users to groups, I have to remember everyone's user name. In our instance, some user names are e-mail addresses, others are not. It's very challenging to add users quickly as I need to toggle back and forth from our user list to determine their user names.

    Would it be possible to have a pop-up appear that has a list of users when you start to type a name? This feature exists in other areas of Compass, and groups seems like a really obvious place where this would be incredibly useful.

    18 Jun 2014
  12. User avatar

    Jim Strange

    When I click on the cog and select "General Configuration," I get a whole load of options in the left sidebar. "Groups" isn't one of them.

    I've successfully created groups and added users to them in the past; now, for some reason, I can't access Group membership at all - the option seems to have disappeared.

    Has Confluence changed? The information on this page is wrong step 2 "Choose Groups in the left-hand panel." is not possible as "Groups" does not exist!

    05 Aug 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Jim, are you managing your users in Confluence, or are you using an external user directory?  I am still seeing the Groups menu in Confluence 5.5, so I'm not sure what might be going on in your instance sorry. 

      06 Aug 2014
  13. User avatar

    Marc De Boeck

    The method "Editing group membership from the user management screen" doesn't seem to be possible in our environment: when I "View" a user, I can see the group membership for that user, but there is no option to Edit the user groups from there. The alternative is to go via "groups", and to edit each group separately.

    We are using Confluence 5.5.4. Our Confluence users are in an external Directory Service for authentication, but the groups are managed locally.

    02 Oct 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Marc, I'm afraid I don't know the answer to this, there are a lot of variables when managing users externally. I'm sure support will be able to help you troubleshoot what is going on though.

      02 Oct 2014
  14. User avatar

    Jean-Paul Suijs

    When I want to add members to a group and type in the username, and click add, it says No users found, When I use the search option with the magnifying glass, I can actually find and select the user, but still when adding it says No users found.

    The users I want to add are in the confluence-users group.

    What am I doing wrong?

    05 Dec 2014
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Jean-Paul,

      I haven't been able to replicate that behaviour on my local instance, so I think it's best you contact support to troubleshoot this issue.

      08 Dec 2014
      1. User avatar

        Jean-Paul Suijs

        Adding the users in JIRA did the job...

        08 Dec 2014
  15. User avatar

    Brandon Blackmoor

    How do I add multiple users to a group in Confluence? Not by having to individually type all of their names, but by simply listing them and marking a checkbox (or "select all")? This is basic, 1995-level functionality, but I can't find it anywhere.

    01 Jul 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Brandon,

      Unfortunately, you can't add users to groups in that fashion in Confluence. If you have a comma-separated list of the users, you can paste it in the Add Members field, but I realise that's likely not what you're looking for.

      Feel free to make a suggestion so we can gauge the interest and keep you updated if there are any changes.

      01 Jul 2015
      1. User avatar

        Brandon Blackmoor

        Do you have a suggestion for how to obtain a comma-separated list of all users?

        01 Jul 2015
        1. User avatar

          Giles Brunning [Atlassian Technical Writer]

          Sorry, no, I'm not aware of a way to create one; there's no way to do it via the Confluence UI.

          01 Jul 2015
          1. User avatar

            Brandon Blackmoor

            You know that's ridiculous, yes?

            02 Jul 2015
            1. User avatar

              Giles Brunning [Atlassian Technical Writer]

              Hi Brandon,

              It's unfortunately not within my control. Your best bet is to make a suggestion so the right people can look at it.

              02 Jul 2015
    1. User avatar

      David Wu

      if you're confluence system admin, you can use sql query get all confluence users from confluence DB and save to a csv file then use Excel process it. if your confluence using LDAP for authentication, you can get comma user list from AD/LDAP server UI. Confluence is very nice providing space level admin which is flexible and effectually reduce system admin working load but is bad on user group management in space level - space admin can't not create or edit space level user group and can't even see group member for a user group - this issue has been raised & vote by many users for a long time but surprisingly Atlassian still ignore this!  

      11 Aug 2015
Powered by Confluence and Scroll Viewport