When logged into their GitLab account, users can customize their experience according to the best approach to their cases.
username is a unique
related to your user ID.
Changing your username
You can change your
username from your
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.
- Existing web URLs for the user and anything under it (i.e. projects) will redirect to the new URLs.
- Existing Git remote URLs for projects under the user will redirect to the new remote URL. Git responses will show a warning with the new remote URL.
- The redirect to the new URL is permanent, that implies the original namespace can't be claimed again by any group or user.
It is currently not possible to rename a namespace if it contains a project with container registry tags, because the project cannot be moved.
Your profile is available from the up-right corner menu bar (user's avatar) > Profile,
On your profile page, you will see the following information:
- Personal information
- Activity stream: see your activity streamline and the history of your contributions
- Groups: groups you're a member of
- Contributed projects: projects you contributed to
- Personal projects: your personal projects (respecting the project's visibility level)
- Snippets: your personal code snippets
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:
- Update your personal information
- Manage 2FA
- Change your username and delete your account
- Manage applications that can use GitLab as an OAuth provider
- Manage personal access tokens to access your account via API and authorized applications
- Add and delete emails linked to your account
- Manage SSH keys to access your account via SSH
- Manage your preferences to customize your own GitLab experience
- Acess your audit log, a security log of important events involving your account