User account | GitLab Docs
/ User account Tier : Free, Premium, Ultimate Offering : GitLab.com, GitLab Self-Managed, GitLab Dedicated Each GitLab account has a user profile, which contains information about you and your GitLab activity. Your profile also includes settings, which you use to customize your GitLab experience. Access your user profile Accessing the profile with the user ID was introduced in GitLab 17.11. To access your profile: In the upper-right corner, select your avatar.
Select your name or username. You can also access a user’s profile page by using the ID instead of the username at https://gitlab.example.com/-/u/<id> . For example, if your username is gitlab-user and your ID is 12345 , you can access the profile page either at https://gitlab.example.com/gitlab-user or https://gitlab.example.com/-/u/12345 . Find the user ID You might need the user ID if you want to interact with it using the GitLab API .
To find the user ID: Go to the user’s profile page. On the profile page, in the upper-right corner, select Actions ( ). Select Copy user ID . Access your user settings To access your user settings: In the upper-right corner, select your avatar. Select Edit profile . Generate or change your Support PIN GitLab Support may ask for a personal identification number (PIN) to validate your identity. The PIN expires seven days after creation.
To generate a new Support PIN: In the upper-right corner, select your avatar. Select Edit profile . In the left sidebar, select Account . Select Generate New PIN . Access your Support PIN If you’ve created a Support PIN previously, the PIN is accessible in your profile and expires seven days after creation. To access your Support PIN: In the upper-right corner, select your avatar. Select Edit profile . In the left sidebar, select Account .
Change your username Your username has a unique namespace , which is updated when you change your username. Before you change your username, read about how redirects behave . If you do not want to update the namespace, you can create a new user or group and transfer projects to it instead. Prerequisites: Your namespace must not: Contain a project with Container Registry tags. Have a project that hosts GitLab Pages . Your username: Must be between 2 and 255 characters in length.
Must only include non-accented letters, digits, _ , - , and . . Must not: Start with _ , - , or . . Contain emoji. End with . or .<reserved file extension> , for example jon.png , jon.git , or jon.atom . However, jonpng is valid. To change your username: In the upper-right corner, select your avatar. Select Edit profile . In the left sidebar, select Account . In the Change username section, enter a new username as the path.
Select Update username . Add emails to your user profile To add a new email address to your account: In the upper-right corner, select your avatar. Select Edit profile . In the left sidebar, select Emails . Select Add new email . In the Email text box, enter the new email. Select Add email address . Verify your email address with the verification email received. The new email address is added as a secondary email address.
You can use secondary email addresses to reset passwords but not to authenticate. You can update your primary email address . Making your email non-public does not prevent it from being used for commit matching and group and project imports . Delete email addresses from your user profile Automatic deletion of unverified secondary email addresses introduced in GitLab 17.0. You can delete a secondary email address from your account.
You cannot delete your primary email address. If the deleted email address is used for any user emails, those user emails are sent to the primary email address instead. Unverified secondary email addresses are automatically deleted after three days. To delete an email address from your account: In the upper-right corner, select your avatar. Select Edit profile . In the left sidebar, select Emails . Select Delete ( ) and confirm you want to Remove .
You can also use the API to delete a secondary email address . Make your user profile page private You can make your user profile visible to only you and GitLab administrators. A GitLab administrator can disable this setting, forcing all profiles to be made public. To make your profile private: In the upper-right corner, select your avatar. Select Edit profile . Select the Private profile checkbox. Select Update profile settings .
The following is hidden from your user profile page ( https://gitlab.example.com/username ): Atom feed Date when account was created Tabs for activity, groups, contributed projects, personal projects, starred projects, snippets Making your user profile page private does not hide all your public resources from the REST or GraphQL APIs. For example, the email address associated with your commit signature is accessible unless you use an automatically-generated private commit email .
User visibility The public page of a user, located at /username , is always visible whether you are signed-in or not. When visiting the public page of a user, you can only see the projects which you have privileges to. If the public level is restricted , user profiles are only visible to authenticated users. Add details to your profile with a README You can add more information to your profile page with a README file.
When you populate the README file with information, it’s included on your profile page. From a new project To create a new project and add its README to your profile: In the upper-right corner, select Create new ( ) and New project/repository . Select Create blank project . Enter the project details: In the Project name field, enter the name for your new project. In the Project URL field, select your GitLab username.
In the Project slug field, enter your GitLab username. All of these fields are case-sensitive. If your username has capital letters, enter it into the project slug field with the capitals included. For Visibility Level , select Public . For Project Configuration , ensure Initialize repository with a README is selected. Select Create project . Create a README file inside this project. The file can be any valid README or index file .
Populate the README file with Markdown , or another supported markup language . GitLab displays the contents of your README above your contribution graph. From an existing project To add the README from an existing project to your profile, update the path of the project to match your username. Add external accounts to your user profile page You can add links to certain other external accounts you might have, like Discord and X (formerly Twitter).
They can help other users connect with you on other platforms. To add links to other accounts: In the upper-right corner, select your avatar. Select Edit profile . In the Main settings section, add your: Discord user ID . BlueSky did:plc identifier . To find your identifier, resolve your user handle . Discord user ID . GitHub username. LinkedIn profile name. Mastodon handle . ORCID . X (formerly Twitter) @username. Your user ID or username must be 500 characters or less.
Select Update profile settings . Add a Mastodon handle Ability to verify Mastodon account using your GitLab user profile added in GitLab 17.4 with a feature flag named verify_mastodon_user . Disabled by default. Ability to verify Mastodon account using your GitLab user profile generally available in GitLab 18.8. Feature flag verify_mastodon_user removed. To add a Mastodon handle: Add Mastodon handle to your GitLab profile.
Sign in to GitLab. In the upper-right corner, select your avatar. Select Edit profile . In the Social accounts section, go to Mastodon and enter your handle. For example: @alex.garcia@exampleServer . Select Update profile settings . Get the verification URI. In the upper-right corner, select your avatar. Select your name or username. On the right side, select your Mastodon handle. Copy the URI from the page that opens.
The rest of this page is on the live site.