gitlab-org--gitlab-foss/doc/user/project/members/index.md
2017-11-10 17:32:18 +00:00

3.5 KiB

Project's members

You can manage the groups and users and their access levels in all of your projects. You can also personalize the access level you give each user, per-project.

You should have master or owner permissions to add or import a new user to your project.

To view, edit, add, and remove project's members, go to your project's Settings > Members.


Add a user

Right next to People, start typing the name or username of the user you want to add.

Search for people


Select the user and the permission level that you'd like to give the user. Note that you can select more than one user.

Give user permissions


Once done, hit Add users to project and they will be immediately added to your project with the permissions you gave them above.

List members


From there on, you can either remove an existing user or change their access level to the project.

Import users from another project

You can import another project's users in your own project by hitting the Import members button on the upper right corner of the Members menu.

In the dropdown menu, you can see only the projects you are Master on.

Import members from another project


Select the one you want and hit Import project members. A flash message notifying you that the import was successful will appear, and the new members are now in the project's members list. Notice that the permissions that they had on the project you imported from are retained.

Members list of new members


Invite people using their e-mail address

If a user you want to give access to doesn't have an account on your GitLab instance, you can invite them just by typing their e-mail address in the user search field.

Invite user by mail


As you can imagine, you can mix inviting multiple people and adding existing GitLab users to the project.

Invite user by mail ready to submit


Once done, hit Add users to project and watch that there is a new member with the e-mail address we used above. From there on, you can resend the invitation, change their access level or even delete them.

Invite user members list


Once the user accepts the invitation, they will be prompted to create a new GitLab account using the same e-mail address the invitation was sent to.

Request access to a project

As a project owner you can enable or disable non members to request access to your project. Go to the project settings and click on Allow users to request access.

As a user, you can request to be a member of a project. Go to the project you'd like to be a member of, and click the Request Access button on the right side of your screen.

Request access button


Project owners & masters will be notified of your request and will be able to approve or decline it on the members page.

Manage access requests


If you change your mind before your request is approved, just click the Withdraw Access Request button.

Withdraw access request button

Share project with group

Alternatively, you can share a project with an entire group instead of adding users one by one.