GitLab Documentation

User account

When logged into their GitLab account, users can customize their experience according to the best approach to their cases.


Your username is a unique namespace related to your user ID.

Changing your username

You can change your username from your profile settings.

Note: If you want to retain ownership over the original namespace and protect the URL redirects, then instead of changing your username, you can create a new group and transfer projects to it. Alternatively, you can follow this detailed procedure from the GitLab Team Handbook.

Changing your username can have unintended side effects.

It is currently not possible to rename a namespace if it contains a project with container registry tags, because the project cannot be moved.

User profile

Your profile is available from the up-right corner menu bar (user's avatar) > Profile, or from

On your profile page, you will see the following information:

Profile settings

You can edit your account settings by navigating from the up-right corner menu bar (user's avatar) > Settings, or visiting

From there, you can: