• Users pending approval
  • View user sign ups pending approval
  • Approve or reject a user sign up
• View users pending role promotion
• Block and unblock users
  • Block a user
  • Unblock a user
• Activate and deactivate users
  • Deactivate a user
  • Automatically deactivate dormant users
  • Automatically delete unconfirmed users
  • Activate a user
• Ban and unban users
  • Ban a user
  • Unban a user
• Delete a user
• Trust and untrust users
• Troubleshooting
  • Deactivate users that have no recent activity
  • Block users that have no recent activity
  • Block or delete users that have no projects or groups

Moderate users (administration)

This is the administration documentation. For information about moderating users in a group, see the group documentation.

GitLab administrators can moderate user access by approving, blocking, banning, or deactivating users.

Users pending approval

A user in pending approval state requires action by an administrator. A user sign up can be in a pending approval state because an administrator has enabled any of the following options:

• Require administrator approval for new sign-ups setting.
• User cap.
• Block auto-created users (OmniAuth)
• Block auto-created users (LDAP)

When a user registers for an account while this setting is enabled:

• The user is placed in a Pending approval state.
• The user sees a message telling them their account is awaiting approval by an administrator.

A user pending approval:

• Is functionally identical to a blocked user.
• Cannot sign in.
• Cannot access Git repositories or the GitLab API.
• Does not receive any notifications from GitLab.
• Does not consume a seat.

An administrator must approve their sign up to allow them to sign in.

View user sign ups pending approval

To view user sign ups pending approval:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. In the search box, filter by State=Pending approval, and press Enter.

Approve or reject a user sign up

A user sign up pending approval can be approved or rejected from the Admin area.

To approve or reject a user sign up:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. In the search box, filter by State=Pending approval and press Enter.
4. For the user sign up you want to approve or reject, select the vertical ellipsis (), then Approve or Reject.

Approving a user:

• Activates their account.
• Changes the user’s state to active.
• Consumes a subscription seat.

Rejecting a user:

• Prevents the user from signing in or accessing instance information.
• Deletes the user.

View users pending role promotion

When user promotion management is enabled, any user added or promoted to a billable role will be pending administrator approval.

To view users pending role promotion:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. Select Role Promotions.

A list of users with the highest role requested is displayed. You can Approve or Reject the requests.

Block and unblock users

GitLab administrators can block and unblock users. You should block a user when you don’t want them to access the instance, but you want to retain their data.

A blocked user:

• Cannot sign in or access any repositories. The blocked user’s data remains in those repositories.
• Cannot use slash commands. For more information, see slash commands.
• Does not occupy a seat. For more information, see billable users.

Block a user

Prerequisites:

• You must be an administrator for the instance.

You can block a user’s access to the instance.

To block a user:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. For the user you want to block, select the vertical ellipsis (), then Block.

The user receives an email notification that their account has been blocked. After this email, they no longer receive notifications.

To report abuse from other users, see report abuse. For more information on abuse reports in the Admin area, see resolving abuse reports.

Unblock a user

A blocked user can be unblocked from the Admin area. To do this:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. In the search box, filter by State=Blocked and press Enter.
4. For the user you want to unblock, select the vertical ellipsis (), then Unblock.

The user’s state is set to active and they consume a seat.

The unblock option may be unavailable for LDAP users. To enable the unblock option, the LDAP identity first needs to be deleted:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. In the search box, filter by State=Blocked and press Enter.
4. Select a user.
5. Select the Identities tab.
6. Find the LDAP provider and select Delete.

Activate and deactivate users

GitLab administrators can deactivate and activate users. You should deactivate a user if they have no recent activity, and you don’t want them to occupy a seat on the instance.

A deactivated user:

• Can sign in to GitLab.
  • If a deactivated user signs in, they are automatically activated.
• Cannot access repositories or the API.
• Cannot use slash commands. For more information, see slash commands.
• Does not occupy a seat. For more information, see billable users.

When you deactivate a user, their projects, groups, and history remain.

Deactivate a user

Prerequisites:

• The user has had no activity in the last 90 days.

To deactivate a user from a self-managed GitLab instance:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. For the user you want to deactivate, select the vertical ellipsis () and then Deactivate.
4. On the dialog, select Deactivate.

The user receives an email notification that their account has been deactivated. After this email, they no longer receive notifications. For more information, see user deactivation emails.

To deactivate users with the GitLab API, see deactivate user. For information about permanent user restrictions, see block and unblock users.

To remove a user from a GitLab.com subscription, see Remove users from your subscription.

Automatically deactivate dormant users

Administrators can enable automatic deactivation of users who either:

• Were created more than a week ago and have not signed in.
• Have no activity for a specified period of time (default and minimum is 90 days).

To do this:

1. On the left sidebar, at the bottom, select Admin.
2. Select Settings > General.
3. Expand the Account and limit section.
4. Under Dormant users, check Deactivate dormant users after a period of inactivity.
5. Under Days of inactivity before deactivation, enter the number of days before deactivation. Minimum value is 90 days.
6. Select Save changes.

When this feature is enabled, GitLab runs a job once a day to deactivate the dormant users.

A maximum of 100,000 users can be deactivated per day.

Automatically delete unconfirmed users

Prerequisites:

• You must be an administrator.

You can enable automatic deletion of users who both:

• Never confirmed their email address.
• Signed up for GitLab more than a specified number of days in the past.

You can configure these settings using either the Settings API or in a Rails console:

 Gitlab::CurrentSettings.update(delete_unconfirmed_users: true)
 Gitlab::CurrentSettings.update(unconfirmed_users_delete_after_days: 365)

When the delete_unconfirmed_users setting is enabled, GitLab runs a job once an hour to delete the unconfirmed users. The job only deletes users who signed up more than unconfirmed_users_delete_after_days days in the past.

This job only runs when the email_confirmation_setting is set to soft or hard.

A maximum of 240,000 users can be deleted per day.

Activate a user

A deactivated user can be activated from the Admin area.

To do this:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. In the search box, filter by State=Deactivated and press Enter.
4. For the user you want to activate, select the vertical ellipsis (), then Activate.

The user’s state is set to active and they consume a seat.

Ban and unban users

GitLab administrators can ban and unban users. You should ban a user when you want to block them and hide their activity from the instance.

A banned user:

• Is blocked from the instance. The banned user’s projects, issues, merge requests, and comments are hidden.
• Does not occupy a seat.

Ban a user

To block a user and hide their contributions, administrators can ban the user.

Users can be banned using the Admin area. To do this:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. For the user you want to ban, select the vertical ellipsis (), then Ban user.

Unban a user

A banned user can be unbanned using the Admin area. To do this:

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. In the search box , filter by State=Banned and press Enter.
4. For the user you want to unban, select the vertical ellipsis (), then Unban user.

The user’s state is set to active and they consume a seat.

Delete a user

Use the Admin area to delete users.

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. For the user you want to delete, select the vertical ellipsis (), then Delete user.
4. Type the username.
5. Select Delete user.

You can also delete a user and their contributions, such as merge requests, issues, and groups of which they are the only group owner.

1. On the left sidebar, at the bottom, select Admin.
2. Select Overview > Users.
3. For the user you want to delete, select the vertical ellipsis (), then Delete user and contributions.
4. Type the username.
5. Select Delete user and contributions.

Trust and untrust users

You can trust and untrust users from the Admin area.

By default, a user is not trusted and is blocked from creating issues, notes, and snippets considered to be spam. When you trust a user, they can create issues, notes, and snippets without being blocked.

Prerequisites:

• You must be an administrator.

Troubleshooting

When moderating users, you may need to perform bulk actions on them based on certain conditions. The following rails console scripts show some examples of this. You may start a rails console session and use scripts similar to the following:

Deactivate users that have no recent activity

Administrators can deactivate users that have no recent activity.

days_inactive = 90
inactive_users = User.active.where("last_activity_on <= ?", days_inactive.days.ago)

inactive_users.each do |user|
    puts "user '#{user.username}': #{user.last_activity_on}"
    user.deactivate!
end

Block users that have no recent activity

Administrators can block users that have no recent activity.

days_inactive = 90
inactive_users = User.active.where("last_activity_on <= ?", days_inactive.days.ago)

inactive_users.each do |user|
    puts "user '#{user.username}': #{user.last_activity_on}"
    user.block!
end

Block or delete users that have no projects or groups

Administrators can block or delete users that have no projects or groups.

users = User.where('id NOT IN (select distinct(user_id) from project_authorizations)')

# How many users are removed?
users.count

# If that count looks sane:

# You can either block the users:
users.each { |user|  user.blocked? ? nil  : user.block! }

# Or you can delete them:
  # need 'current user' (your user) for auditing purposes
current_user = User.find_by(username: '<your username>')

users.each do |user|
  DeleteUserWorker.perform_async(current_user.id, user.id)
end