2021-01-29 00:20:46 +05:30
---
2021-09-04 01:27:46 +05:30
stage: Manage
group: Access
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2021-09-04 01:27:46 +05:30
# Members of a project **(FREE)**
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
Members are the users and groups who have access to your project.
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
Each member gets a role, which determines what they can do in the project.
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
## Add users to a project
Add users to a project so they become members and have permission
to perform actions.
Prerequisite:
2021-09-04 01:27:46 +05:30
- You must have the [Maintainer or Owner role ](../../permissions.md ).
2021-06-08 01:23:25 +05:30
To add a user to a project:
2021-09-04 01:27:46 +05:30
1. Go to your project and select **Project information > Members** .
1. 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 ](#add-a-member-modal-window ).
2021-09-30 23:02:18 +05:30
1. Select a [role ](../../permissions.md ).
2021-06-08 01:23:25 +05:30
1. Optional. Choose an expiration date. On that date, the user can no longer access the project.
1. 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.
2021-09-04 01:27:46 +05:30
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.
2021-06-08 01:23:25 +05:30
## Add groups to a project
2021-09-04 01:27:46 +05:30
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.
2021-06-08 01:23:25 +05:30
Prerequisite:
2021-09-04 01:27:46 +05:30
- You must have the [Maintainer or Owner role ](../../permissions.md ).
2021-06-08 01:23:25 +05:30
To add groups to a project:
2021-09-04 01:27:46 +05:30
1. Go to your project and select **Project information > Members** .
2021-06-08 01:23:25 +05:30
1. On the **Invite group** tab, under **Select a group to invite** , choose a group.
2021-09-30 23:02:18 +05:30
1. Select the highest max [role ](../../permissions.md ) for users in the group.
2021-06-08 01:23:25 +05:30
1. Optional. Choose an expiration date. On that date, the user can no longer access the project.
1. 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 ](../../group/index.md#namespaces ), 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:
2021-09-04 01:27:46 +05:30
- You must have the [Maintainer or Owner role ](../../permissions.md ).
2021-06-08 01:23:25 +05:30
To import users:
2021-09-04 01:27:46 +05:30
1. Go to your project and select **Project information > Members** .
2021-06-08 01:23:25 +05:30
1. On the **Invite member** tab, at the bottom of the panel, select **Import** .
1. Select the project. You can view only the projects for which you're a maintainer.
1. Select **Import project members** .
A success message is displayed and the new members are now displayed in the list.
2018-03-17 18:26:18 +05:30
2020-01-01 13:55:28 +05:30
## Inherited membership
2021-09-04 01:27:46 +05:30
When your project belongs to a group, group members inherit their role
from the group.
2020-01-01 13:55:28 +05:30
2021-03-11 19:13:27 +05:30
![Project members page ](img/project_members_v13_9.png )
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
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 ](../../permissions.md ) and member of all groups.
They have inherited their role from the **demo** group.
2021-09-30 23:02:18 +05:30
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.
2021-09-04 01:27:46 +05:30
## 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.
Prerequisite:
- You must have the [Owner role ](../../permissions.md ).
- Optional. Unassign the member from all issues and merge requests that
are assigned to them.
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
To remove a member from a project:
1. Go to your project and select **Project information > Members** .
1. Next to the project member you want to remove, select **Remove member** ** {remove}**.
1. Optional. In the confirmation box, select the **Also unassign this user from related issues and merge requests** checkbox.
1. Select **Remove member** .
2020-01-01 13:55:28 +05:30
2021-03-11 19:13:27 +05:30
## Filter and sort members
2020-01-01 13:55:28 +05:30
2021-03-11 19:13:27 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/21727) in GitLab 12.6.
> - [Improved](https://gitlab.com/groups/gitlab-org/-/epics/4901) in GitLab 13.9.
2021-04-17 20:07:23 +05:30
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/issues/299954) in GitLab 13.10.
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
You can filter and sort members in a project.
2021-03-11 19:13:27 +05:30
2021-09-04 01:27:46 +05:30
### Display inherited members
2021-03-11 19:13:27 +05:30
2021-09-04 01:27:46 +05:30
1. Go to your project and select **Project information > Members** .
1. In the **Filter members** box, select `Membership` `=` `Inherited` .
1. Press Enter.
2021-03-11 19:13:27 +05:30
![Project members filter inherited ](img/project_members_filter_inherited_v13_9.png )
2021-09-04 01:27:46 +05:30
### Display direct members
2021-03-11 19:13:27 +05:30
2021-09-04 01:27:46 +05:30
1. Go to your project and select **Project information > Members** .
1. In the **Filter members** box, select `Membership` `=` `Direct` .
1. Press Enter.
2021-03-11 19:13:27 +05:30
![Project members filter direct ](img/project_members_filter_direct_v13_9.png )
### Search
You can search for members by name, username, or email.
![Project members search ](img/project_members_search_v13_9.png )
### Sort
You can sort members by **Account** , **Access granted** , **Max role** , or **Last sign-in** in ascending or descending order.
![Project members sort ](img/project_members_sort_v13_9.png )
2020-01-01 13:55:28 +05:30
2021-09-04 01:27:46 +05:30
## Request access to a project
2021-09-30 23:02:18 +05:30
GitLab users can request to become a member of a project.
2021-09-04 01:27:46 +05:30
1. Go to the project you'd like to be a member of.
1. By the project name, select **Request Access** .
![Request access button ](img/request_access_button.png )
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
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.
2021-04-29 21:17:54 +05:30
2021-09-04 01:27:46 +05:30
If a project does not have any maintainers, the notification is sent to the
most recently active owners of the project's group.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
If you change your mind before your request is approved, select
**Withdraw Access Request**.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
## Prevent users from requesting access to a project
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
You can prevent users from requesting access to a project.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Prerequisite:
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
- You must be the project owner.
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
1. Go to the project and select **Settings > General** .
1. Expand the **Visibility, project features, permissions** section.
1. Under **Project visibility** , select **Users can request access** .
1. Select **Save changes** .
2021-02-22 17:27:13 +05:30
2021-09-04 01:27:46 +05:30
## Share a project with a group
2018-03-17 18:26:18 +05:30
2021-09-04 01:27:46 +05:30
Instead of adding users one by one, you can [share a project with an entire group ](share_project_with_groups.md ).
2020-10-04 03:57:07 +05:30
2021-04-29 21:17:54 +05:30
### Add a member modal window
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/247208) in GitLab 13.11.
> - [Deployed behind a feature flag](../../feature_flags.md), 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](#enable-or-disable-modal-window). **(FREE SELF)**
WARNING:
This 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:
2021-09-04 01:27:46 +05:30
1. Go to your project and select **Project information > Members** .
1. Select **Invite members** .
1. Enter an email address and select a role.
1. Optional. Select an **Access expiration date** .
2021-04-29 21:17:54 +05:30
1. Select **Invite** .
### Enable or disable modal window **(FREE SELF)**
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 ](../../../administration/feature_flags.md )
can enable it.
To enable it:
```ruby
Feature.enable(:invite_members_group_modal)
```
To disable it:
```ruby
Feature.disable(:invite_members_group_modal)
```