Deleting a User account

Users can be deleted from a GitLab instance, either by:

NOTE: Note: Deleting a user will delete all projects in that user namespace.

As a user

As a user, you can delete your own account by:

  1. Clicking on your avatar.
  2. Navigating to Settings > Account.
  3. Selecting Delete account.

As an administrator

As an administrator, you can delete a user account by:

  1. Navigating to Admin Area > Overview > Users.
  2. Selecting a user.
  3. Under the Account tab, clicking:
  4. Delete user to delete only the user but maintaining their associated records.
  5. Delete user and contributions to delete the user and their associated records.

Associated Records

  • Introduced for issues in GitLab 9.0.
  • Introduced for merge requests, award emoji, notes, and abuse reports in GitLab 9.1.
  • Hard deletion from abuse reports and spam logs was introduced in GitLab 9.1, and from the API in GitLab 9.3.

When a user account is deleted, not all associated records are deleted with it. Here's a list of things that will not be deleted:

Instead of being deleted, these records will be moved to a system-wide user with the username "Ghost User", whose sole purpose is to act as a container for such records. Any commits made by a deleted user will still display the username of the original user.

When a user is deleted from an abuse report or spam log, these associated records are not ghosted and will be removed, along with any groups the user is a sole owner of. Administrators can also request this behavior when deleting users from the API or the Admin Area.