Members of a project

Members are the users and groups who have access to your project.

Each member gets a role, which determines what they can do in the project.

Add users to a project

Add users to a project so they become members and have permission to perform actions.

Prerequisite:

To add a user to a project:

  1. Go to your project and select Project information > Members.
  2. On the Invite member tab, under GitLab member or Email address, type the username or email address. In GitLab 13.11 and later, you can replace this form with a modal window.
  3. Select a role.
  4. Optional. Choose an expiration date. On that date, the user can no longer access the project.
  5. Select Invite.

If the user has a GitLab account, they are added to the members list. If you used an email address, the user receives an email.

If the invitation is not accepted, GitLab sends reminder emails two, five, and ten days later. Unaccepted invites are automatically deleted after 90 days.

If the user does not have a GitLab account, they are prompted to create an account using the email address the invitation was sent to.

Add groups to a project

When you add a group to a project, each user in the group gets access to the project. Each user’s access is based on:

  • The role they’re assigned in the group.
  • The maximum role you choose when you invite the group.

Prerequisite:

To add groups to a project:

  1. Go to your project and select Project information > Members.
  2. On the Invite group tab, under Select a group to invite, choose a group.
  3. Select the highest max role for users in the group.
  4. Optional. Choose an expiration date. On that date, the user can no longer access the project.
  5. Select Invite.

The members of the group are not displayed on the Members tab. The Members tab shows:

  • Members who are directly assigned to the project.
  • If the project was created in a group namespace, members of that group.

Import users from another project

You can import another project’s users to your own project. Users retain the same permissions as the project you import them from.

Prerequisite:

To import users:

  1. Go to your project and select Project information > Members.
  2. On the Invite member tab, at the bottom of the panel, select Import.
  3. Select the project. You can view only the projects for which you’re a maintainer.
  4. Select Import project members.

A success message is displayed and the new members are now displayed in the list.

Inherited membership

When your project belongs to a group, group members inherit their role from the group.

Project members page

In this example:

  • Three members have access to the project.
  • User 0 is a Reporter and has inherited their role from the demo group, which contains the project.
  • User 1 belongs directly to the project. In the Source column, they are listed as a Direct member.
  • Administrator is the Owner and member of all groups. They have inherited their role from the demo group.

If a user is a direct member of a project, the expiration date can be updated. If membership is inherited from a parent group, the expiration date can be updated only from the parent group itself.

Remove a member from a project

If a user is a direct member of a project, you can remove them. If membership is inherited from a parent group, then the member can be removed only from the parent group itself.

Prerequisites:

  • You must have the Owner role.
  • Optional. Unassign the member from all issues and merge requests that are assigned to them.

To remove a member from a project:

  1. Go to your project and select Project information > Members.
  2. Next to the project member you want to remove, select Remove member .
  3. Optional. In the confirmation box, select the Also unassign this user from related issues and merge requests checkbox.
  4. To prevent leaks of sensitive information from private projects, verify the user has not forked the private repository. Existing forks continue to receive changes from the upstream project. You may also want to configure your project to prevent projects in a group from being forked outside their group.
  5. Select Remove member.

Filter and sort members

Version history

You can filter and sort members in a project.

Display inherited members

  1. Go to your project and select Project information > Members.
  2. In the Filter members box, select Membership = Inherited.
  3. Press Enter.

Project members filter inherited

Display direct members

  1. Go to your project and select Project information > Members.
  2. In the Filter members box, select Membership = Direct.
  3. Press Enter.

Project members filter direct

You can search for members by name, username, or email.

Project members search

Sort

You can sort members by Account, Access granted, Max role, or Last sign-in in ascending or descending order.

Project members sort

Request access to a project

GitLab users can request to become a member of a project.

  1. Go to the project you’d like to be a member of.
  2. By the project name, select Request Access.

Request access button

An email is sent to the most recently active project maintainers. Up to ten project maintainers are notified. Any project maintainer can approve or decline the request.

If a project does not have any maintainers, the notification is sent to the most recently active owners of the project’s group.

If you change your mind before your request is approved, select Withdraw Access Request.

Prevent users from requesting access to a project

You can prevent users from requesting access to a project.

Prerequisite:

  • You must be the project owner.
  1. Go to the project and select Settings > General.
  2. Expand the Visibility, project features, permissions section.
  3. Under Project visibility, select Users can request access.
  4. Select Save changes.

Share a project with a group

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

Add a member modal window

Version history
  • Introduced in GitLab 13.11.
  • Deployed behind a feature flag, disabled by default.
  • Enabled on GitLab.com.
  • Recommended for production use.
  • Replaces the existing form with buttons to open a modal window.
  • To use in GitLab self-managed instances, ask a GitLab administrator to enable it.
cautionThis feature might not be available to you. Check the version history note above for details.

In GitLab 13.11, you can optionally replace the form to add a member with a modal window. To add a member after enabling this feature:

  1. Go to your project and select Project information > Members.
  2. Select Invite members.
  3. Enter an email address and select a role.
  4. Optional. Select an Access expiration date.
  5. Select Invite.

Enable or disable modal window

The modal window for adding a member is under development and is ready for production use. It is deployed behind a feature flag that is disabled by default. GitLab administrators with access to the GitLab Rails console can enable it.

To enable it:

Feature.enable(:invite_members_group_modal)

To disable it:

Feature.disable(:invite_members_group_modal)